Repository navigation
docs(site): add the Diátaxis documentation site - #147
Conversation
…starter Twenty pages across tutorials, how-to guides, reference, and explanation, generated from docs/, the Wiki pages, and the engine source, each ending with its source line. Builds green with search and sitemap; a resolver over the built HTML found zero broken internal links. The Pages workflow is added but Pages is not enabled here. Refs #131
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
Warning Review limit reachedNext included review available in 20 minutes. View limit detailsLimit details: You’ve used all 2 included reviews currently available. You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Review configuration: ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Team Run ID: ⛔ Files ignored due to path filters (3)
📒 Files selected for processing (27)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Why
Wayfinder #131, phase P4. The repository's
docs/and the Wiki were reorganised into a Diátaxis site on the fixed AOJ Astro Starlight starter, so installers get tutorials, how-to guides, reference, and explanation from one place.Scope
docs-site/: generated once with the starter'screate_site.py, then twenty authored pages: two tutorials, five how-to guides, five reference pages, three explanation pages, plus section indexes. Every authored page ends with its source line. Plugin install is labelled planned..github/workflows/docs.yml: the bundled Pages workflow with the site path set. Pages is not enabled; that is the owner's gate.Verification
bun install,bun run check(0 errors), andbun run build(21 pages, search index, sitemap) succeed.Refs #131.
Written by a Claude Fable 5 lane on dev-substrate from a written brief; reviewed and committed by Claude Fable 5.1 running in Claude Code as the program coordinator.