The docs site (inspectrobots.org, built by `.github/workflows/docs.yml` from `docs/` + `mkdocs.yml`) has fallen behind the README, which was recently reworked (#147) and now has a logo the site itself never uses (the navbar still shows a generic Material Design robot icon).
Scope:
- Migrate the site from MkDocs Material to Docusaurus.
- Preserve the load-bearing features of the current setup:
- auto-generated Python API reference (currently mkdocstrings; needs a generation step feeding Docusaurus),
- `llms.txt` / `llms-full.txt` at the same URLs (the README links to them),
- existing inbound URLs (`/guide/quickstart/`, `/api/`, ...),
- strict build in CI + GitHub Pages deploy with the `inspectrobots.org` CNAME,
- search.
- Refresh content to match the improved README (tagline, install flow, CLI including `view`, plugin list).
- Use the real logo (`docs/assets/inspect-robots-logo.svg`) for navbar, favicon, and social card.
Plan will land in `plans/` per repo convention.
The docs site (inspectrobots.org, built by `.github/workflows/docs.yml` from `docs/` + `mkdocs.yml`) has fallen behind the README, which was recently reworked (#147) and now has a logo the site itself never uses (the navbar still shows a generic Material Design robot icon).
Scope:
Plan will land in `plans/` per repo convention.