Skip to content

fix: canonicalize math routing and wire orphan pages into sidebar navigation#56

Closed
scaleborg wants to merge 1 commit intomainfrom
fix/navigation-ia-cleanup
Closed

fix: canonicalize math routing and wire orphan pages into sidebar navigation#56
scaleborg wants to merge 1 commit intomainfrom
fix/navigation-ia-cleanup

Conversation

@scaleborg
Copy link
Owner

Summary

  • Add /math hub page with canonical child routes /math/refresh and /math/bridge, with legacy redirects from /math-refresh and /math-bridge
  • Wire 9 previously orphaned pages into sidebar navigation across Learning, Career, Projects, Business, and Docs sections
  • Rename "Side Projects" sidebar section to "Business"
  • Add 6 docs deep-dive sub-items under Docs > How It Works

Changes by stage

Math routing canonicalization

  • New MathLandingView with two entry cards (Refresh + Bridge)
  • /math/refresh and /math/bridge as canonical routes
  • /math-refresh and /math-bridge redirect with search params preserved
  • Reference deep links (/reference?section=math-refresh) untouched

Stage A1 - Learning + Career wiring

  • Cognitive Toolkit, Behavioral Design added to Learning
  • Career Foundations added to Career
  • Learning and Career header active states extended

Stage A2 - Projects + Business wiring

  • OSS Projects, HF Projects added to Projects
  • Brand Studio, Execution Playbook added to Business
  • Parent header active states extended

Stage B1 - Section rename

  • "Side Projects" → "Business" (label + aria labels only, no key changes)

Stage B2 - Docs deep-dives

  • 6 new sub-items: Ingestion Pipeline, Chat Pipeline, Career Intelligence, Observability, Architecture Reference, MCP Ecosystem
  • /how-gpu-works intentionally left in Reference > GPUs (different domain)
  • /how-mcp-works needed new mcp_ecosystem ViewId + pathname detection (was the only true orphan with zero sidebar infrastructure)

Test plan

  • npx tsc --noEmit - 0 errors
  • pnpm lint - 0 errors (11 pre-existing warnings)
  • Playwright: all 6 math routes navigate correctly, legacy redirects work
  • Playwright: all Stage A1/A2 items navigate + show active state
  • Playwright: Business section label, expand/collapse, active state verified
  • Playwright: all 6 docs deep-dive routes navigate + show SubNavItem active
  • Playwright: Docs header data-active="true" strictly verified on all 6 deep-dive routes
  • /how-gpu-works confirmed untouched (remains in Reference only)
  • No other sidebar sections affected (verified via snapshot diffs)

🤖 Generated with Claude Code

…vigation

Navigation IA cleanup covering math route consolidation and sidebar
discoverability improvements across multiple sections.

Math routing:
- Add /math hub page (MathLandingView) with cards linking to Refresh and Bridge
- Add canonical child routes /math/refresh and /math/bridge
- Legacy /math-refresh and /math-bridge redirect to canonical paths
- Reference deep links untouched

Sidebar wiring (Stage A1 - Learning + Career):
- Add Cognitive Toolkit and Behavioral Design to Learning section
- Add Career Foundations to Career section
- Extend Learning header active state for new items + broadened math_

Sidebar wiring (Stage A2 - Projects + Business):
- Add OSS Projects and HF Projects to Projects section
- Add Brand Studio and Execution Playbook to Business section
- Extend parent header active states for new items

Section rename (Stage B1):
- Rename "Side Projects" to "Business" (label + aria only)

Docs deep-dives (Stage B2):
- Add 6 deep-dive sub-items under Docs > How It Works:
  Ingestion Pipeline, Chat Pipeline, Career Intelligence,
  Observability, Architecture Reference, MCP Ecosystem
- Extend Docs header active state for all deep-dive routes
- Add mcp_ecosystem ViewId and pathname detection for /how-mcp-works
- /how-gpu-works intentionally left in Reference section

Verified: tsc 0 errors, lint 0 errors, Playwright confirmed navigation
and active state for all new items across all affected routes.
@scaleborg
Copy link
Owner Author

Superseded by two smaller scoped PRs:

@scaleborg scaleborg closed this Mar 15, 2026
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