miniblog.

Perhaps the biggest driver of docs success is prestige. How cool are the docs tools, and how proud are you to have contributed to the docs? Which tools do this best? Racket docs look pretty great, for example.

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.

Sure, your templating language might be good, but is it so good that the manual includes a warning for addiction? 🙃