Start here
Answers to questions met mid-task, each written up once and kept where a search finds it again. Press / or use the search box; every page opens with the short answer.
Every entry is one of five kinds:
| Kind | What it is | What the build checks |
|---|---|---|
| howto | One question, a three-line answer, then the detail | The answer is one to three lines |
| snippet | A howto whose code lives in examples/ and is shown verbatim |
The example compiles and runs |
| recipe | Ingredients as data, so portions and units can change on the page | Every volume has a density |
| reference | Tables, lists and links, under a short answer | The answer is one to three lines |
| decision | A choice about my own setup: the choice, when, what lost and why, and what replaced it | The answer is short, the date is a day, a replacement is a current decision, and the entry stays private |
Every entry is private unless it says public: true: signed in, you see all of them, each private one labelled; without a login the site shows only the public ones, and the rest do not exist to it.
Topics are the folders in the sidebar; a new folder is a new topic. Five views cut across them: the timeline lists entries by the month they were added, the recent changes list every change to an entry, newest first, tags groups them by what they touch, all entries is one list sortable by date, title, kind or topic, and the graph draws every entry and the links between them. Every entry’s page draws its own neighbourhood under Related.