Repository navigation
Description
Issue Format and Issue Hierarchy currently live as large top-level Ways of Working pages with inbound links and navigation entries throughout the repository. They must move into the new OKF subtree without creating a broken intermediate state.
Request
Atomically relocate the existing guidance to Issues/Process/Format.md and Issues/Types/Hierarchy.md, create the Issues, Process, and Types indexes, and update navigation plus every inbound path and anchor in the same pull request. Preserve existing semantics; later Tasks own the new process and type content.
Acceptance criteria
src/docs/Ways-of-Working/Issues/index.md,Process/index.md, andTypes/index.mdexist with complete frontmatter and generated navigation tables- Issue Format is moved to
Issues/Process/Format.md - Issue Hierarchy is moved to
Issues/Types/Hierarchy.md src/zensical.tomlpoints to the new locations- Every inbound repository link and heading anchor resolves to the new paths
- No compatibility stub, duplicate legacy page, or unindexed issue-guidance page remains
- Page content changes only where required for paths, titles, or navigation
- Index check, link validation, lint, clean Zensical build, CI, and Copilot review are green
Technical decisions
Atomic cutover: File moves, indexes, navigation, and all inbound references land together because deferring references would make the first pull request fail its own link and index checks.
Stable concepts: Format remains the universal body-format owner; Hierarchy remains the type and containment overview. Later Tasks split detailed process and type rules into nearby pages.
No redirect stubs: OKF indexes provide discovery. Old filenames are removed rather than preserved as duplicate routing pages.
Implementation plan
Relocation
- Inventory all inbound links and anchors to Issue Format and Issue Hierarchy
- Create the indexed Issues/Process and Issues/Types structure
- Move the two pages without semantic expansion
- Update Zensical navigation and every inbound reference
Validation
- Regenerate and verify documentation indexes
- Validate links, lint, and clean site build
- Complete CI and the Copilot review loop
Activity
MariusStorhaug commentedon Jul 25, 2026
Implementation started from live
origin/mainat92d25fcafter confirming bootstrap squashd4c4a15is an ancestor.MariusStorhaug commentedon Jul 25, 2026
Atomic relocation is published in draft PR #91 from commit
2215cae.MariusStorhaug commentedon Jul 25, 2026
Local validation is complete for draft PR #91.
pwsh -NoProfile .github/scripts/Update-DocumentationIndex.ps1 -Checkpassedpwsh -NoProfile .github/scripts/Test-DocumentationLink.ps1passed: all documentation links resolvezensical build --cleanpassed with no issuesMariusStorhaug commentedon Jul 25, 2026
PR #91 has completed its automated gates.
COMMENTED, zero inline comments, and a clean-round resultMariusStorhaug commentedon Jul 25, 2026
PR #91 is ready for human review and squash auto-merge is enabled.
BLOCKED; it has not merged📖 [Docs]: Issue guidance now follows the OKF structure (#91)