miniblog.

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.

I'm increasingly persuaded that the best kind of architecture diagrams are ASCII text art. It seems to be the only format that others will edit. I keep seeing an antipattern where someone draws a comprehensive diagram and it keeps getting used even as it becomes less accurate.

@cstanhope In theory it's not giving them much more data: I already have to give the company meter readings. https://www.telegraph.co.uk/money/consumer-affairs/six-reasons-say-no-smart-meter/ and https://www.the-ambient.com/explainers/smart-meters-2020-uk-guide-explainer-2153/ persuaded me against getting a smart meter though. The former link suggests I won't save money or escape confusing bills, and the latter suggests the early standards haven't won. It'll probably win eventually, for better or worse.