docs: restructure the wiki along Diátaxis
Seven pages carried all four modes at once. Anvil-Chunk-Loader opened with
status, ran through usage, architecture, a comparison, measured tables and
error handling in one file; Light-Engine, Benchmarking, Installation,
Instances-And-Chunks and World-Migration had the same shape. Every paragraph
was correct and no reader was ever in all four states at once.
The four quadrants are now separate pages, encoded in the title because that
is the only structure a wiki preserves: 1 tutorial, 10 how-tos, 9 reference
pages, 15 explanation pages. Project-Status and the Research pages stay
outside the four on purpose — they are the operational record, not
documentation of the software — and so does the build documentation.
Three things the split fixed rather than moved:
- There was no tutorial anywhere. Tutorial-Load-your-first-world-with-Falco
is the one guided path: empty Gradle project to a served world with light,
one path, no alternatives.
- Reference existed only as prose embedded in explanation. The nine pages now
carry generator banners naming the source in the code repository, so the
next step is a generator and a CI drift gate rather than proofreading.
Reference-Exceptions-and-faults says outright that it is incomplete: the
two Reason enums declare eleven constants and the wiki ever recorded two.
- The measured tables were published twice. The four charts lived only in
Benchmarking, their tables only in Measured-Results, and _Footer.md carried
a rule about which source wins — the symptom, not the cure. The charts now
sit with their tables on Reference-Measured-results and the duplicate block
is gone; every figure in it was verified present first. Same for the
reproduction command lines, which stood in two pages.
Prose was moved, not rewritten. What is not carried over is the intros and
tables of contents of the dissolved pages, and the duplicated headline
block. All 195 cross-page links, their anchors and their link texts were
rewritten to the new titles; nothing dangles.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>