The modern wiki software shipped by Gitlab and Github assumes that everyone writes their docs just for the platform, and the project will never need to leave. Their strange syntax means nobody can just use the regular markdown notes they might have, either for their own purposes or from another Git project. Gitlab's …

Read More

This article was written for the lazy bear's Vim Carnival I have notes on lots of things. When you write notes in markdown it's called 'a knowledge base', which sounds classy. So now I have lots of knowledge bases, and I strive to keep them bland and featureless. A good knowledge base has no fancy features. Features …

Read More

Obsidian is a note-taking app with a proprietary licence. This makes it prone to the usual abusive behaviours. But I only hear good things about it: Obsidian is ultimately just a markdown editor, so you can extract all of your notes in plain text any time you want, without fear of lock-in. It sounds like the users are …

Read More

IT documentation has a disease: in-text links. The disease-inducing thinking is quite clear: someone writing the documentation writes 'install the drivers for your graphics card', and then provides a link to how to install graphics cards because they saw others do that sort of thing. But once you accept the general …

Read More