Skip to content

feat(docs): reorder product dropdown by agent lifecycle#693

Open
khushalsonawat wants to merge 1 commit into
devfrom
docs/product-dropdown-order
Open

feat(docs): reorder product dropdown by agent lifecycle#693
khushalsonawat wants to merge 1 commit into
devfrom
docs/product-dropdown-order

Conversation

@khushalsonawat

Copy link
Copy Markdown
Contributor

What

Reorders the Docs section-switcher dropdown (the product menu in the sidebar) from alphabetical to agent-development-lifecycle order, grouped under lightweight phase headers:

Start              → Get Started
Observe & diagnose → Observability · Error Feed
Evaluate & measure → Evaluation · Simulation · Dataset
Improve            → Optimization · Annotations
Build & connect    → Prompt · Prototype · Agent Playground · Knowledge Base · Agent Command Center
Protect            → Protect
Assistant          → Falcon AI
Reference          → Integrations · Guides · SDK Reference · API Reference

Resources is omitted; Falcon AI sits last among products.

Why

Most users arrive to see, measure, and fix an agent they already have, not to build one from scratch, so observe/evaluate/improve lead and build sits lower. Phase headers keep a 15-item list scannable.

Notes

  • Dropdown-only. Does not touch the groups array in navigation.ts, so the left sidebar page-list still follows nav order.
  • Applied to the live dropdown in Sidebar.astro (Docs tab only; other tabs fall back to a single unlabelled list). A More bucket surfaces any unplaced product so nothing silently disappears.
  • Reference group links out to the Integrations/Guides/SDK/API tabs — these were not previously in the dropdown.
  • Removes the dead SectionSwitcher.astro and Breadcrumb.astro components (nothing rendered them; DocsLayout uses its own inline breadcrumb).
  • astro build passes — 931 pages, no errors.

Reorder the Docs section-switcher dropdown from alphabetical to
agent-development-lifecycle order, grouped under lightweight phase
headers (Start, Observe & diagnose, Evaluate & measure, Improve,
Build & connect, Protect, Assistant, Reference). "Resources" is
omitted and "Falcon AI" sits last.

The change lands on the live dropdown in Sidebar.astro (Docs tab only;
other tabs fall back to a single unlabelled list). A "More" bucket
surfaces any future product that isn't placed, so nothing silently
disappears.

Remove the dead SectionSwitcher.astro and Breadcrumb.astro components:
nothing rendered them (DocsLayout uses its own inline breadcrumb), and
the build of all 931 pages passes without them.
@khushalsonawat khushalsonawat self-assigned this Jun 29, 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