miniblog.

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

Really cute introduction to Smalltalk programming from 1983. It starts with an explanation of mice and "scroll menus" (scroll bars), then shows cross-referencing code, lints, autofixes, and inspecting instances of newly defined objects! https://youtu.be/JLPiMl8XUKU