Navigation: six tabs, sentence-case labels that match page titles, moved pages redirected #723

Parent

#698

What to build

The nav becomes six tabs: Get started (Why Ferro, installation, quickstart), Guide, How-to, Concepts, Reference (Python API, CLI, configuration, exceptions, migrations reference, RLS reference), Project (FAQ, roadmap, upgrading between versions, changelog, contributing). Labels are sentence case and equal their page's H1; same-named pages get distinct names ("Testing with Ferro", "Testing migrations"); the adopting how-to moves under Schema management; the upgrade guide moves to Project; the pages created by the split tickets (#714, #715) are wired in; the Next steps page is deleted. Every moved page gets a redirect_maps entry and every internal link is updated. Pages get front matter with a description, and status: new where the page is new in this epic.

Acceptance criteria

• The nav has exactly the six tabs above, and every page in docs/pages (except includes) is in it.
• Every nav label equals its page's H1.
• Every moved or deleted page's old URL redirects.
• Every page has a front-matter description.

Files owned

• Modify: zensical.toml, docs/pages/** (front matter, links, moved files)
• Delete: docs/pages/getting-started/next-steps.md
• Test: tests/test_docs_migrations.py

Interfaces

• Consumes: redirect_maps (site config ticket (Docs site config: Zensical features, Markdown extensions, API reference options and a strict build #701))
• Consumes: new pages from the migrations-split and RLS ticket (Split the row-level security page and fix its example #715)s
• Produces: nothing other tickets rely on

Test scenarios

• Happy path: the strict build passes with every page in the nav.
• Integration: the old URLs of the moved pages resolve to redirects in the built site.

Verify

uv run --no-sync zensical build --clean --strict
uv run --no-sync pytest tests/test_docs_site.py -q --no-cov -p no:cacheprovider
uv run --no-sync pytest tests/test_docs_migrations.py -q --no-cov -p no:cacheprovider -n 8
uv run --no-sync pytest tests/test_docs_examples.py -q --no-cov -p no:cacheprovider -n 8

Blocked by

• Get started pages: home page and README, Why Ferro, installation and quickstart #705, Project pages: FAQ, roadmap, contributing and changelog #706, Upgrade guide covers every release up to the current one #707, Models and fields page with a generated field type table #708, Queries guide and the typed predicates concept page: lambda-only story, results shown, one running example #709, Aggregations guide: real data without ties, results shown, error checks that can fail #710, Mutations, transactions and connections guides, and the multiple-databases how-to #711, Relationships and raw SQL guides #712, Schema management pages: fix stale facts and pin every quoted generated step file #713, Split the migrations guide: tutorial loop, how-tos, a squash page, and reference tables in Reference #714, Split the row-level security page and fix its example #715, How-tos: testing, pagination, timestamps and soft deletes #716, Migrating from SQLAlchemy: show sessions, make every block run #717, Concepts pages: architecture, identity map, type safety, backends and performance #718, Docstrings: connect, fields, checks, row security, raw SQL, sessions, settings and exceptions #720, API reference completeness: every public object has an entry, pages named after their objects #722

Audit findings