miniblog.

I've been playing with Obsidian and having a great time. It's fundamentally a .md editor but it has so many affordances that it feels different. Link autocompletion, highlighting backreferences, polished mobile app. A lot of teaching resources focus on folder structure, oddly.

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?

Should programming language docs come with exercises for the reader to test their understanding? This feels like a great way to help people learn, and you could even measure docs by pass rate. I've seen online books occasionally use this format, but never official resources.