Skip to content

Create the OKF issue guidance section #85

Description

The issue model needs a dedicated OKF subtree so agents can navigate from a small index to process guidance or the body rules for one native issue type without loading a monolithic format page.

Request

Create the Ways-of-Working/Issues/ section by relocating the existing issue guidance atomically, then add separate process and type pages. Preserve green navigation and links at every step.

Acceptance criteria

  • Issues/index.md routes readers into Process and Types subtrees
  • Process contains concise Format, Lifecycle, Planning, and Relationships pages
  • Types contains a concise Hierarchy overview plus Epic, PBI, Task, and Bug pages
  • Every page has title and description frontmatter and one clear conceptual owner
  • Existing Issue Format and Issue Hierarchy content is relocated without broken inbound links, anchors, navigation, or generated indexes
  • Workflow remains authoritative for phase definitions
  • Sub-issues, dependencies, and parallelism have one canonical explanation
  • The four native operational issue types have distinct, non-duplicative body and lifecycle guidance
  • All child pull requests pass index, link, lint, clean-build, CI, and Copilot review gates

Technical decisions

Structure: Process and Types are separate indexed subtrees so their child Tasks can proceed independently after the atomic relocation.

Atomic relocation: Moving the existing pages, navigation entries, generated indexes, and every inbound reference is one Task and one pull request. No compatibility stubs remain.

Parallel content: After relocation, Process content and Types content touch separate subtrees and may execute in parallel.

Small pages: Each page states one concept once and links outward rather than copying Workflow or another type page.


Delivery plan

Delivery is tracked through native Task sub-issues. Relocation completes first; Process and Types content then proceed as dependency-free siblings and may run concurrently.

Metadata

Metadata

Labels

NoReleaseNo release required

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions