"you either have enough cultural context that [one word] will suffice or else 100s of words of explanation wouldn’t be enough: [...] Emacs."
miniblog.
Related Posts
A really nice explanation of lisp semantics, using userland code!
For example, you can define let in terms of let* and vice versa.
Anecdotally, I've noticed more frequent doc comments in languages that put them inside the function (e.g. Python, Lisp) rather than outside (JS, Rust).
Perhaps it's easier to write the rough signature before the explanation?
A fun 1994 article about the first purchase on the web using encryption!
Phil Brandenberger uses his visa credit card, X-Mosaic and PGP to purchase a $12 'compact audio disk' by Sting.
It includes an explanation of the World Wide Web too :)
https://www.nytimes.com/1994/08/12/business/attention-shoppers-internet-is-open.html