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 site clean, 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
       

Result

Emacs 29.3 (Org mode 9.6.15)