tools/docs_start.py
asxeem/openaliro
Module

docs_start.py

Give the rendered site a real "Get started" landing.

tools/docs_start.py

Overview

Give the rendered site a real "Get started" landing.

The hero's Get-started button used to deep-link straight into the ESP32 bring-up checklist — an fine first page for exactly one kind of reader. This pass builds start.html instead: one landing that holds every track (hardware, toolchain, build and test, firmware internals, protocol research, project and CI), each a card that drills down in place to the commands, installs and guides that track needs. The page is assembled from an existing rendered guide page, so it always carries the current shell — sidebar, palette, theme toggle and the other passes' injections.

Also part of wayfinding, on every page:

  * the sidebar gains a Get-started entry next to Overview,
  * the search button gets the visual weight a primary control deserves
    (accent tint, a couple of attention pings on load) and the palette a
    springier open — search is how readers actually move around, so it
    should not look like chrome.

Run from the repo root, after docs_github.py and before docs_graph.py, so the page exists before the sitewide shims and the link pass run.

Undocumented (7)

repo_url, chip, row, main_html, build_page, add_search_row, main