docs site: materialize the 20 [TODO]-stub pages#342
Merged
Conversation
Contributor
Author
|
The documentation is clear and easy to read. It is human-first and does not use an overabundance of AI-generated semantics (emdash, semicolon run-on sentences, etc) 
|
clkao
changed the base branch from
spacedock-ensign/mkdocs-material-docs-site
to
main
Fill every stub page in the MkDocs site with real content, grounded in the repository (README, the dev-workflow reference, the skills, the cmd/ and internal/ command surface, docs/specs, and the docs/roadmap sprint records) and conformed to docs/site/contributing/voice-and-tone.md. - Get started: Home, first launch, first workflow. - Concepts: operating model, workflows & entities, stage lifecycle, gates & decisions, and a worked example tracing the real z9 codex-plugin-auto-install entity (PR #329) through every stage. - Running workflows: commission, survey, operating, debrief & refit. - Advanced: sprints & roadmap, mods & standing teammates, split-root state. - Reference: command reference, frontmatter contract. - Contributing: proof policy, adding a runtime, architecture notes. No [TODO] markers remain; `mkdocs build --strict` passes (all internal links and nav entries resolve). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy-edit pass over the 20 materialized pages to remove prose em-dashes, a common tell of AI-generated text. Each instance was reworked for the sentence rather than swapped uniformly: periods where the dash joined an independent clause, colons for definitions and lists, parentheses for true asides, light commas, and outright restructures where no substitute read naturally. Em-dashes inside code spans and fenced blocks (the gate-review template, a bash comment, the inline workflow-not-found error string) are literal content and left intact. No technical facts, commands, flags, paths, links, role names, or stage names changed; `mkdocs build --strict` passes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
clkao
force-pushed
the
spacedock-ensign/docs-site-materialize-todos
branch
from
b030489 to
0db381a
Compare
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
2 participants
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.
Fills every
[TODO]-stub page in the MkDocs site with real content, grounded in the repository and conformed to the Voice & tone guide.Per the thread on #315, this branches off PR #341 (
spacedock-ensign/mkdocs-material-docs-site) and targets it as the base, rather than committing to #341 directly — so #341 can merge after the flip with the docs already materialized on its branch.What changed
20 stub pages went from a one-line
[TODO]placeholder to full content:z9codex-plugin-auto-installentity (PR Codex plugin auto-install onspacedock codex(mirror #311; codex 0.137.0 marketplace + plugin add) #329) through every stage.How it was written
Each page was written grounded in real repo source (the
README, the dev-workflow reference, theskills/*/SKILL.mddefinitions, thecmd/andinternal/command surface,docs/specs/, and thedocs/roadmap/sprint records), then independently reviewed against the voice guide and spot-checked for factual accuracy against the repo.Verification
[TODO]markers remain; each page keeps exactly one# h1.mkdocs build --strictpasses — every internal link and nav entry resolves.0198-pre-flip-hardeningsprint directory, PR Codex plugin auto-install onspacedock codex(mirror #311; codex 0.137.0 marketplace + plugin add) #329, the invertedTestCodexFrontDoorNoPluginFailsFastWithoutInstallingtest).🤖 Generated with Claude Code