miniblog.

There are docs resources like https://diataxis.fr/ that categorise documents based on format and intended audience. They don't say where you should start, or what order you should write docs. I'm currently thinking README > reference > tutorial > how-tos. Agree/disagree?

Today I learnt that Lua projects often use *3* spaces for indentation! https://github.com/luarocks/lua-style-guide/blob/master/README.md#indentation-and-formatting I initially thought something was very wrong with editor config.

Explaining syntax-aware diffing is tricky, so I'm trying to add some compelling screenshots to the difftastic readme. They need to demonstrate weaknesses in text diffing, and be small enough to be mobile friendly. Here's the current examples.