Task: Consolidate site top navigation
Table of Contents
This page documents a task in the Documentation improvements story. It captures the goal, current status, acceptance, and any notes or results.
Goal
An external (Gemini) UX review of the redesigned homepage flagged the
site-wide top nav's four dropdowns (Project, Modeling, Developer,
Resources) as fragmenting the user journey. Group developer technical
specs and model definitions under a single unified Docs dropdown,
reducing the top-level dropdown count. This is a site-wide change
(every page's site-html-preamble in ores-build-site.el, not just
index.org), so it needs its own careful pass over what's currently
in each dropdown before restructuring.
Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent story | Documentation improvements |
| Now | Not yet started. |
| Waiting on | Nothing. |
| Next | Begin implementation. |
| Last touched | 2026-08-04 |
Acceptance
- Nav dropdown count reduced (fewer than the current 4 top-level groups), with developer technical specs and model definitions consolidated under one Docs-style grouping.
- Every existing nav link still resolves correctly on every page (the preamble is injected site-wide, so a broken link here breaks every page, not just one).
- No regression in the site build (
compass build --direct siteclean, no broken id-links).
Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
Notes
Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario, run
through the QA Validation Runner panel) that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
PRs
| PR | Title |
|---|---|
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|