Every story and comment from the Hacker News API, in a layout borrowed from 2001.
A comment on How do you write simple explanations without sounding condescending?.
A complete but shallow explanation works to get early engagement.
I try to avoid analogies.
Each building-block topic in its own paragraph. From front to back. That is, start at the visible layer and work down.
Try to use neutral or group pronouns: we, it, "the system"
Reiterate feedback/question loop invite at the end.
There are no comments on this comment yet.
A complete but shallow explanation works to get early engagement.
I try to avoid analogies.
Each building-block topic in its own paragraph. From front to back. That is, start at the visible layer and work down.
Try to use neutral or group pronouns: we, it, "the system"
Reiterate feedback/question loop invite at the end.