Every problem note owes at least three internal links:
- One parent concept — the thing you have to understand for the note to make sense. If it does not exist yet, create it in
content/concepts/, even as three lines. Three honest lines beat a dangling link. - One or two sibling problems — notes that looked similar, or that were confused with this one during the investigation. Say which, and why they are not the same.
- One hub — add a line to the relevant map. Hubs are maintained in reverse: you open the map document and add the row yourself. Nothing does it for you.
Mechanics
- Internal links are always wikilinks:
[[slug|display text]]. Markdown link syntax is reserved for external URLs, so a glance at the raw file tells you which links leave the site. - Link inside sentences, not in a “Related” dump at the bottom. A link in a sentence carries the reason it exists; a link in a list carries nothing and rots silently.
- A link that only says “see also” is not worth the three links quota. Say what the reader will find on the other side.
Related: capture workflow, tag taxonomy.