Skip to content

Docs IA v2 (2.46)

MkDocs navigation and recipes.md hub regroup for 2.xx — developer diagnostics, experimental sweep, Gallery expansion matrices, and tranche-1 checkpoints. Not a full site redesign (1.36 layout stays).

Find docs in ≤2 clicks: Recipes hub → section tables · MkDocs Planning + Recipes · Gallery Recipes hub mirrors rows.

Related: roadmap.md 2.46 · Planning hub · python scripts/smoke_gallery.py

What moved (2.46 → planning IA)

Bucket MkDocs nav Recipes hub section
Dev vs retail FPS Recipes → 2.xx developer → Developer diagnostics 2.xx developer & stability
FL-004 badges / defer Recipes → 2.xx developer → Experimental sweep same
Friction / strategy / expansion Planning → … Planning & product expansion
2.21…2.38 Gallery matrix Recipes → 2.xx controls → Gallery catalog expansion 2.xx controls & Gallery
Slice docs (Calendar, wrap grid, …) Recipes → 2.xx controls → … same
2.50 / 2.60 / 3.00 audits Recipes → Quality → 2.xx checkpoints Quality & checkpoints

Unchanged: 1.xx getting-started rows, component API index, stable-api top-level tab, legacy webview2-future redirect.

Gallery Recipes → Recipes hub (RecipesHubPage) lists the same doc paths as the hub tables — open the matching demo with Open. Planning & product expansion block added for docs/planning/.

Smoke: python scripts/smoke_gallery.py (catalog + Gallery --smoke).

Maintainer checklist

  1. Add a 2.xx recipe doc → row in recipes.md and mkdocs.yml under Recipes or Planning.
  2. Expansion / friction docs → docs/planning/ + Planning nav + recipes.md Planning & product expansion section.
  3. If the doc has a Gallery demo → row in RecipesHubPage.qml with the same docs/… path.
  4. Run python scripts/smoke_gallery.py after doc edits.
  5. Regenerate component index when bumping product version: python scripts/generate_component_docs.py.