📖 [Docs]: Issue guidance now follows the OKF structure - #91
Merged
Marius Storhaug (MariusStorhaug) merged 1 commit intoJul 25, 2026
Merged
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
7 tasks
Copilot started reviewing on behalf of
Marius Storhaug (MariusStorhaug)
July 25, 2026 20:09
View session
There was a problem hiding this comment.
Pull request overview
This PR reorganizes issue-related guidance under the Ways-of-Working/Issues subtree (aligned to the OKF structure), adding section indexes and updating navigation and inbound links so readers (and agents) can jump directly to issue Process vs Types guidance.
Changes:
- Updated Zensical navigation to introduce an Issues → Process / Types hierarchy with canonical paths.
- Added generated index pages for Issues, Issue Process, and Issue Types.
- Updated references across Ways of Working and Agents docs to point to the new canonical Issue Format and Issue Hierarchy locations.
Reviewed changes
Copilot reviewed 17 out of 17 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| src/zensical.toml | Replaces top-level Issue Format/Hierarchy nav entries with an Issues subtree (Process/Types). |
| src/docs/Ways-of-Working/Workflow.md | Updates Issue Format/Hierarchy links to new canonical locations. |
| src/docs/Ways-of-Working/Spec-Driven-Development.md | Updates Issue Format/Hierarchy references to new canonical locations. |
| src/docs/Ways-of-Working/Issues/index.md | Adds Issues section landing page with generated index table. |
| src/docs/Ways-of-Working/Issues/Process/index.md | Adds Issue Process landing page with generated index table. |
| src/docs/Ways-of-Working/Issues/Process/Format.md | Adjusts relative links after relocation; points hierarchy references to Types/Hierarchy. |
| src/docs/Ways-of-Working/Issues/Types/index.md | Adds Issue Types landing page with generated index table. |
| src/docs/Ways-of-Working/Issues/Types/Hierarchy.md | Adjusts relative links after relocation (e.g., Goal-Setting/Principles references). |
| src/docs/Ways-of-Working/index.md | Replaces separate Issue Format/Hierarchy entries with a single Issues entry. |
| src/docs/Ways-of-Working/Goal-Setting.md | Updates Issue Hierarchy link to new canonical location. |
| src/docs/Ways-of-Working/Fleet-Orchestration.md | Updates Issue Format link to new canonical location. |
| src/docs/Ways-of-Working/Documentation-Model.md | Updates Issue Format references to new canonical location. |
| src/docs/Ways-of-Working/Definition-of-Ready-and-Done.md | Updates Issue Hierarchy link to new canonical location. |
| src/docs/Ways-of-Working/Contribution-Workflow.md | Updates Issue Format link to new canonical location. |
| src/docs/Ways-of-Working/Branching-and-Merging.md | Updates Issue Hierarchy link (including anchor) to new canonical location. |
| src/docs/Agents/implement.md | Updates Issue Format link used by agent implementation guidance. |
| src/docs/Agents/define.md | Updates Issue Format/Hierarchy links used by agent issue authoring guidance. |
Marius Storhaug (MariusStorhaug)
marked this pull request as ready for review
July 25, 2026 20:11
Marius Storhaug (MariusStorhaug)
enabled auto-merge (squash)
July 25, 2026 20:12
This was referenced Jul 25, 2026
Marius Storhaug (MariusStorhaug)
disabled auto-merge
July 25, 2026 20:36
Marius Storhaug (MariusStorhaug)
deleted the
docs-89-relocate-issue-guidance
branch
July 25, 2026 20:36
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue guidance is now organized under the OKF Issues section, with dedicated Process and Types navigation so readers and agents can drill directly into format or hierarchy guidance.
Changed: Issue guidance follows the OKF structure
The existing Issue Format and Issue Hierarchy pages retain their established guidance at their new canonical locations. All repository navigation and references now resolve through the indexed Issues subtree, and the retired top-level paths no longer exist.
Technical Details
Related issues