chore: retire Docusaurus site, rewrite README for the Astro docs#403
Merged
Conversation
The docs now live in site/ (Astro + Starlight) and deploy from there (#400/#401). Remove the superseded website/ Docusaurus project, and: - rewrite README.md around site/ + cookbook/ (was Docusaurus instructions) - Makefile `serve` now runs the Astro dev server - test-deploy workflow builds site/ on PRs to master (was website/ on `main`, which never ran) with npm ci --ignore-scripts Verified: go test ./... passes, site builds clean (124 pages). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Post-cutover cleanup now that the docs are live from
site/(Astro/Starlight, #400) and the CI is hardened (#401).Changes
website/— the superseded Docusaurus project (105 files removed). The live deploy already buildssite/, so nothing serving depends on it. Rollback for the cutover is still available via the merged commits' history if ever needed.README.md— was Docusaurus run instructions; now documents thesite/(Astro) workflow,cookbook/recipes, layout, and deployment.Makefile—servenow runs the Astro dev server (was a Docker/Docusaurus command againstwebsite/).test-deploy.yaml— buildssite/on PRs tomaster(waswebsite/via yarn, triggered onmain— which never ran), withnpm ci --ignore-scriptsand least-privilegecontents: read.Verified
go test ./...passes (cookbook unaffected);site/builds clean (124 pages); no brokenwebsite/references remain (the leftover "website" hits are the English word in prose).🤖 Generated with Claude Code