2026-09-15
Gap: Development record not publishable
The project keeps a detailed internal development log for every merged change, not written for outside readers: it named internal people and tools, ended entries with a raw test report, and used images sized for internal review. This entry covers two problems: making that record publishable, and reconciling documentation and the open-issue list around one current build.
Gap: Development record not publishable
A review of the internal entries found most named individuals or tooling directly, every entry ended with a raw test-run report, and embedded images ran to tens of megabytes, unfit for a public, professional audience.
The development-log section was rebuilt: nine entries, covering five weeks of work, rewritten in third person with internal names and process detail removed, test-report tails dropped, and titles reduced to a flat statement of the problem each closed. Images were converted to a lighter web format and capped in size.
Nine public entries cover the project's recent history end to end, each capped at 500 words, with a shared index page listing them newest first.
Dead end: a text check of the rewritten copy came back clean, but a visual check caught internal notes drawn onto two pictures rather than written as selectable text, invisible to text checks. Both were re-cut. A shared page style was briefly lost in an unrelated cleanup and restored.
Gap: Documentation and open issues drifted from the shipping build
Documentation, rules, and the open-issue list had accumulated references to earlier world-map and river states: an older elevation source, an old vertical scale, older waterfall rules, after the build had moved past them.
The current build was declared the reference baseline, and documentation, rules, and the open-issue list were reconciled against it in one pass: outdated references removed, stale issues closed, and a convention adopted for documentation sections created ahead of their content, so they stay minimal until real material exists.
Reference material was reorganized, not deleted; the open-issue list now reflects only what is unresolved on the current build.
Dead end: one follow-up change during this reconciliation went further than intended, altering rendering behavior instead of leaving it as-is; caught and reverted the same day once the scope, matching documentation to the build without changing it, was clarified.