Skip to content

docs: group and collapse left navigation sections#3360

Merged
dgageot merged 1 commit into
mainfrom
docs/reduce-nav-length
Jul 1, 2026
Merged

docs: group and collapse left navigation sections#3360
dgageot merged 1 commit into
mainfrom
docs/reduce-nav-length

Conversation

@aheritier

Copy link
Copy Markdown
Contributor

Closes #3359

The docs left-nav had ~75 items listed flat, making it hard to scan. This PR reduces visual length without moving or renaming any pages.

Changes:

  • Each top-level section is now a collapsible <details>/<summary> accordion; the active section opens automatically
  • Built-in Tools (24 items) split into 5 sub-categories: File & Shell, Agent Coordination, Memory & Knowledge, Planning & Reasoning, Interaction
  • Guides + Community merged into a single "Resources" collapsible section
  • Prev/next page-nav updated to traverse sub-groups so no page is dropped
  • CSS: summary chevron (rotates on open), sub-category labels, sub-item indent

All 81 nav URLs preserved verbatim. Jekyll build clean (only pre-existing Liquid warnings in hooks/agents docs). Go code untouched.

- Wrap each nav section in <details>/<summary> for accordion collapse;
  the active section (containing the current page) opens automatically
- Group Built-in Tools into 5 sub-categories: File & Shell, Agent
  Coordination, Memory & Knowledge, Planning & Reasoning, Interaction
- Merge standalone Guides and Community sections into a single
  Resources section with sub-labels
- Update page-nav.html prev/next to traverse both flat items and
  grouped items so no page is dropped
- Add CSS for summary chevron, sub-category labels, and sub-item indent

All 81 nav URLs are preserved verbatim; no pages were moved or renamed.

Fixes #3359
@aheritier aheritier requested a review from a team as a code owner July 1, 2026 10:54
@aheritier aheritier added kind/feat PR adds a new feature (maps to feat:). Use on PRs only. area/docs Documentation changes labels Jul 1, 2026
@dgageot dgageot merged commit fd89f2f into main Jul 1, 2026
13 checks passed
@rumpl rumpl deleted the docs/reduce-nav-length branch July 1, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation changes kind/feat PR adds a new feature (maps to feat:). Use on PRs only.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: reduce left navigation menu length

2 participants