Skip to content

fix: keep navigation active on deep documentation pages - #3

Merged
PeterRamotowski merged 9 commits into
mainfrom
fix/pages-navigation-tree
Sep 2, 2026
Merged

fix: keep navigation active on deep documentation pages#3
PeterRamotowski merged 9 commits into
mainfrom
fix/pages-navigation-tree

Conversation

@PeterRamotowski

Copy link
Copy Markdown
Owner

Fixes

  • replace the hand-maintained MkDocs nav block with a metadata-driven navigation hook
  • include all principle, Core Skill, profile, modifier, language, framework, and evaluation detail pages in the actual navigation tree
  • group the 72 principles by their canonical categories so the long catalogue stays structured and collapsible
  • add explicit landing pages for Decision system, Technologies, Examples, and Reference
  • fix the Reference top-level route so it resolves to /reference/ instead of a missing implicit section page
  • keep the correct top tab and primary sidebar active on third-level pages

Verification

A temporary branch-only workflow (removed before this PR) successfully ran repository validation, normative linting, documentation generation, and mkdocs build. It also asserted against the generated HTML that:

  • /reference/ is built
  • Principles is the active top tab on Avoid Accidental Complexity
  • the primary sidebar is present and contains that active principle
  • Decision system is active on a reusable-library profile detail page

The distribution manifest was refreshed with the repository's existing manifest generator.

@PeterRamotowski
PeterRamotowski merged commit b8a517c into main Sep 2, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant