Many of the GNU manuals are incredibly good. For example, the diff manual includes worked examples: https://www.gnu.org/software/diffutils/manual/html_node/Example-Context.html
What's the secret? My docs are getting better, but they're not on this level.
Related Posts
I'm not sure if I should use the term "text diff" or "textual diff" to refer to a conventional, line-oriented diff of text in difftastic.
Any opinions? Which seems clearer to you?
Some delightful examples of good compiler error messages in the latest Gleam release: https://gleam.run/news/context-aware-compilation/
I've been writing docs for different programming language operators (+, *, == and so on). Each one gets a separate web page.
I've suddenly realised that / is much harder! docs/+ and docs/== is fine, but docs// just doesn't work as a URL in a static site.
Any ideas?