Skip to content

docs: Migrate site docs to Starlight#337

Merged
dcramer merged 1 commit into
mainfrom
docs/starlight-migration
May 20, 2026
Merged

docs: Migrate site docs to Starlight#337
dcramer merged 1 commit into
mainfrom
docs/starlight-migration

Conversation

@dcramer
Copy link
Copy Markdown
Member

@dcramer dcramer commented May 20, 2026

Move the docs site onto Starlight with the Sentry theme while preserving the custom homepage as the root experience.

Information Architecture

Split the old long-form pages into workflow, skill, GitHub setup, warden.toml, and CLI reference sections. The sidebar now separates product story from reference material, with GitHub workflow configuration kept out of the warden.toml reference.

Docs Runtime

Add the Starlight content collection, legacy redirects, Sentry theme wiring, and a small nanoid compatibility shim needed by the current Astro/Starlight build graph.

Move the documentation site onto Starlight with the Sentry theme while keeping the existing custom homepage. Split the docs into workflow, skill, GitHub, config, and CLI reference pages so the sidebar follows the product story more clearly.

Keep legacy routes redirected to their new Starlight pages and title file-backed examples so workflow and config snippets show where they belong.

Co-Authored-By: GPT-5 Codex <noreply@anthropic.com>
@dcramer dcramer marked this pull request as ready for review May 20, 2026 22:15
@dcramer dcramer merged commit 95d0b7d into main May 20, 2026
19 checks passed
@dcramer dcramer deleted the docs/starlight-migration branch May 20, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant