News for hackers. Stuff that matters.
Re:Ask HN: An article using The Little Schemer format, what ... by dingosity on Wednesday August 07, 2024 @10:10AM (#41181645)
First things first... hella props for just going out and doing something creative.

Things I like:

1. It's obvious where sections begin and end.

2. PLENTY or margin and padding. I know some people try to cram as much info on a single line as possible. My old eyes prefer spacing; it helps them track the text.

3. With one exception (mentioned below) the font sizes seem to "look good."

Things I might suggest are improvable:

1. It's not obvious what the show/hide button at the top of the page does at first glance. The button is at the top of the page and its effects are seen at the bottom of the page. Maybe put another copy of the button immediately above the answer section?

2. Continuing the show/hide theme, the per-answer-section show/hide button hides the content, but maintains the blank space in the document. That seems "wrong" to me since I have to scroll past complete blank areas when looking at it on my phone. And I think we could have no end of discussion whether those buttons should be at the top or bottom of the section that gets hidden. I'd just suggest trying putting them at the top and see if they look better to you.

3. The "Objective", "Question", "Result", "Answer" sub-section headers seem like they should be a little bigger.

I don't know if you tested some of these options, and completely defer to you if you tested them and they look even weirder. Just my $0.02. Mostly looks great.

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Wednesday August 07, 2024 @11:29AM (#41182399)
1) At the top of the page, the button reads: "SHOW ANSWERS."

2.1) There is no more blank space.

2.2) Buttons are at the top right of each QA.

3) Headers font size: 1.1rem -> 1.2rem

It looks better to me!

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Wednesday August 07, 2024 @10:26AM (#41181809)
Great, thank you for your answer. I will make a few adjustments.
Re:Ask HN: An article using The Little Schemer format, what ... by dingosity on Wednesday August 07, 2024 @10:38AM (#41181951)
NP. I love seeing people experiment. Thanks for listening.
Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Wednesday August 07, 2024 @09:49AM (#41181469)
Hello HN,

I'm experimenting with an article format and would like to know what you think of it. This format draws inspiration from The Little Schemer, using a sequence of Q&A. This particular article covers the basics of p5.js.

Thank you for your constructive remarks.

PHF

Re:Ask HN: An article using The Little Schemer format, what ... by pwg on Wednesday August 07, 2024 @10:30AM (#41181851)
Does not render at all (blank screen) with javascript turned off by uBlockOrigin.
Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Wednesday August 07, 2024 @10:36AM (#41181921)
I see. Thank you for reporting. P.S. There are no ads or trackers of any kind on the website.
Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Sunday August 11, 2024 @04:24AM (#41214767)
I can't see how to make the site usable without JS. It uses WebComponents (https://lit.dev) and JS here and there.
Re:Ask HN: An article using The Little Schemer format, what ... by chuckadams on Saturday August 10, 2024 @06:45PM (#41212786)
The individual “Show Answer” buttons are doing nothing on mobile Safari, though the top toggle button does work. Those fixed top buttons are also eating up a lot of space on a phone.

Otherwise, looks quite nice!

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Sunday August 11, 2024 @02:48AM (#41214411)
> Those fixed top buttons are also eating up a lot of space on a phone.

It should be fixed now.

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Sunday August 11, 2024 @03:27AM (#41214528)
> The individual “Show Answer” buttons are doing nothing on mobile Safari.

It should be fixed.

            :host(.hidden), :host(.hidden) * {
                /*
                 * display: none; does not work because of a bug.
                 * bug: https://bugs.webkit.org/show_bug.cgi?id=188259
                 */
                visibility: hidden;
                width: 0;
                height: 0;
            }
Re:Ask HN: An article using The Little Schemer format, what ... by sivers on Saturday August 10, 2024 @07:30PM (#41212987)
I'm a fan of the Little Schemer, so I'm happy you're trying this format. I hope you keep trying more than once. Sometimes these things take a while to get right and find the sweet spot.

Little Schemer was instantly appealing because it starts so simply:

    1. Is it true this is an atom? : atom
    2. Is it true this is an atom? : turkey
    3. Is it true this is an atom? : 1942
    6. Is it true this is a list? (atom)
    7. Is it true this is a list? (atom turkey or)
I came to your page wanting to learn P5.js, but it started a little too involved.

Consider starting with a few simpler questions and answers like this, which also helps just teach the format and interface, before asking the reader to work their brain much harder.

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Sunday August 11, 2024 @02:24AM (#41214334)
Ok, got it!
Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Tuesday August 13, 2024 @11:13AM (#41236266)
1. I have re-written a good part of the article to make the learning curve less steep.

2. The concepts to be illustrated are now mentioned in the "Discussion" section.

It is still not as detailed as The Little Schemer, but is it any good anyway?

Re:Ask HN: An article using The Little Schemer format, what ... by layer8 on Saturday August 10, 2024 @07:40PM (#41213013)
“Show answer” should better be below the question, where the answer appears. Also so you don’t have to scroll up again for longer questions.
Re:Ask HN: An article using The Little Schemer format, what ... by neilv on Saturday August 10, 2024 @07:58PM (#41213073)
That would help a lot. Tuning on top of that would be graphic design, and maybe animated transition (if the graphic design isn't enough to expose what was happening).
Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Sunday August 11, 2024 @02:34AM (#41214358)
Ok! Buttons are now below questions, is it better?
Re:Ask HN: An article using The Little Schemer format, what ... by layer8 on Sunday August 11, 2024 @07:44AM (#41215521)
Yes, but Hide Answer should either be in the same place (so you can quickly toggle), or (for longer answers) it needs to automatically scroll up again because otherwise you land below the next question; or both.

Showing/hiding larger content with good UX isn't easy. Sometimes it's better to just stick with normal browser navigation (such as linking to answers on a separate page), where the browser takes care of proper navigation state.

Re:Ask HN: An article using The Little Schemer format, what ... by phfrohring on Monday August 12, 2024 @05:12AM (#41222587)
A solution may be to avoid longer answers.