Skip to content

[Change] docs-13: Fix navigation, add search, theme toggle & role-based navigation #123

Description

@djm81

OpenSpec Change: docs-13-nav-search-theme-roles

Why

docs-06 through docs-12 created per-bundle command pages, overview pages, workflow consolidation, and team/enterprise docs, but the sidebar navigation was never updated to link to them. Three bundles (Code Review, Spec, Govern) still point to generic /reference/commands/, Codebase is missing command pages, Team & Enterprise links to stale paths, and Workflows omits four new guides. The homepage has the same stale links. Beyond navigation fixes, the site lacks light/dark mode, search, and role-based navigation.

What Changes

  • Fix all broken sidebar and homepage links across all bundles and sections
  • Extract navigation into _data/nav.yml to prevent future drift
  • Add light/dark mode toggle with SpecFact brand colors, localStorage persistence, theme-aware Mermaid
  • Add Lunr.js client-side search with front matter metadata index, keyboard shortcuts
  • Add expertise-level filter (beginner/intermediate/advanced) and role-based homepage entry cards
  • Enrich front matter with keywords, audience, expertise_level on all pages
  • Refine theme — cleaner sidebar, better code blocks, breadcrumbs, both light/dark modes

Capabilities

New: docs-nav-data-driven, docs-theme-toggle, docs-client-search, docs-role-expertise-nav
Modified: bundle-overview-pages, cross-module-workflow-docs, team-setup-docs, modules-docs-command-validation

Artifacts

Dependencies

Depends on: docs-06 through docs-12 (all implemented)

Metadata

Metadata

Assignees

Labels

change-proposalProposal for a new changedocumentationImprovements or additions to documentationopenspecopenspec change

Fields

No fields configured for User Story.

Projects

Status
Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions