Lint Checklist

Every wiki edit must pass these mechanical checks before the editor stops. Failures are the wiki’s bug list.

1. Orphan pages

Failure: a note has no inbound wikilinks from any other note or [[Index]].

Verify:

• Obsidian → Graph view → toggle “Orphans”. Any node not in a connected component is an orphan.
• Or: grep -r "\[\[Note Title\]\]" Wiki/ for the candidate. Zero hits = orphan.

Fix: add the entry to [[Index]] under the right category, and add at least one inbound link from a topically related note.

2. Contradictions across pages

Failure: two notes assert different facts about the same thing (e.g. one says concurrency is 40, another says 100).

Verify:

• grep -ri "concurrency\|limit\|version\|port" Wiki/ for numeric claims and compare.
• Read newly edited notes alongside the notes they link to.

Fix: reconcile to one source of truth. Mark the older claim with a > [!stale] callout citing the resolution date and the canonical note.

3. Stale claims (out-of-date code refs)

Failure: a note cites a file path, function name, table column, or behaviour that no longer matches the repo.

Verify:

• For every code reference in the edited note, run ls <path> or grep -n <symbol> <file> against the repo at ./.
• Cross-check against git log --oneline -20 for recent renames or deletes.

Fix: update the reference. If the wider context is also stale, wrap the affected paragraph in > [!stale] YYYY-MM-DD — reason. Never silently delete.

4. Concept missing its own page

Failure: a concept is mentioned in 3 or more notes but has no dedicated note of its own.

Verify:

• grep -roih "[A-Z][a-z]\+ [A-Z][a-z]\+" Wiki/ | sort | uniq -c | sort -rn | head -40 to surface frequent capitalised phrases.
• Cross-check the top results against [[Index]].

Fix: file a > [!todo] in [[Known Issues]] (or wherever fits) requesting the new note. Do not create empty stubs.

5. Index drift

Failure: a note exists on disk but is not listed in [[Index]], or the index lists a note that does not exist.

Verify:

• ls Wiki/*.md and compare line-by-line with the entries in Wiki/Index.md.

Fix: add or remove the index entry. Every existing note appears exactly once.

6. Log not updated

Failure: structural changes were made but [[log]] has no new entry for the date.

Verify: open Wiki/log.md. Last entry should match today’s edit.

Fix: append a dated entry summarising what changed.