miniblog.

← Back to all posts
Nov 13, 2022 at 04:28
Writing docs like characters in a novel: give people a purpose! https://thenewstack.io/an-engineers-best-tips-for-writing-documentation-devs-love/

Related Posts

Jan 18, 2026 at 16:46
32
Show, don't tell: effective advice for writing for both LLMs and people!
Prompting 101: Show, don’t tell
Prompting 101: Show, don’t tell
Improve your prompts with better examples rather than better instructions
Jan 16, 2026 at 10:26
26
I see people advocating for writing a FAQ, but I really struggle to write one from scratch. The best FAQs are written as a response to, well, frequent questions. How do you populate the initial FAQ?
Nov 7, 2025 at 12:30
4
I've been learning some Common Lisp by writing some simple JSON munging programs. I'm sure it's not best practice — I should probably deserialise to CLOS automatically — but it's a nice way to get comfortable with the basics. It feels weird deliberately ignoring helpers though.