I'm increasingly thinking that comments are more trouble than they're worth. If a PL just had strings, code rewriting tools would be easier.
miniblog.
Related Posts
There are docs resources like https://diataxis.fr/ that categorise documents based on format and intended audience.
They don't say where you should start, or what order you should write docs.
I'm currently thinking README > reference > tutorial > how-tos. Agree/disagree?
On thinking of books like software, treating them as evolving artifacts, and URLs versus paper book publishers:
Thinking more about the "auto eval definitions" approach, I think it breaks down when debugging. If I want to step through the existing definition, it'd be really awkward to re-evaluate the definition at my cursor.