I'm increasingly persuaded that a page-per-function organisation of docs is the best.
For example, this command in Redis has its own page: https://redis.io/commands/acl-cat/
Using a whole page enables you to have several examples without overwhelming the reader.
miniblog.
Related Posts
Replacing npm (the tool and the organisation) with a federated alternative by npm inc's former CTO! https://www.theregister.co.uk/2019/06/04/npm_cj_silverio_javascript/
(I had no idea that so many registries were sprouting!)
Remacs has moved to its own GitHub organisation, to reflect the growing community! https://github.com/remacs
We have a whole bunch of friendly contributors :)
Useful metrics, vanity metrics, and organisation alignment: