This repository was archived by the owner on May 9, 2026. It is now read-only.
docs(v1): site-mode README + migration guide + STATE refresh (T-7.3 + T-7.4 partial)#146
Merged
Merged
Conversation
…(T-7.3+T-7.4 partial) Pre-stages T-7.3 (README v1 rewrite) + T-7.4 (STATE.md refresh) docs in parallel with Eng B's T-7.1 docs sweep (separate paths — they touch docs/adr/ + docs/CONTENT-PROTOCOL.md + docs/guides/, this PR touches README.md + docs/migration-v0.2-to-v1.0.md + STATE.md). - README.md — adds prominent "Two modes (v1, ADR-0021)" section near the top: explains headless vs site mode + points at the migration guide. Existing scaffolder/quick-start sections unchanged. - docs/migration-v0.2-to-v1.0.md (new) — TL;DR upgrade for headless installs (just bump deps + run doctor); spec/storage table of changes with backwards-compat notes; site-mode opt-in walkthrough (config flag → scaffold → sections layout → renderer); breaking- change list (rare; only matters for internal-import consumers); rollback notes. - STATE.md — refreshed package versions to match npm reality (#110) + reflect v1 phases shipped: admin 0.4.2 with v1.0.0 queued, create 0.4.0 with --theme=marketing, blocks-marketing 0.1.0 new, renderer 0.1.0 scaffold. Header line updated to v1.0 release prep status. T-7.3 (full): full clear-admin command reference + integration guides (Astro/React/SDK) + REST docs deferred to v1.0.x — covered by issue referencing #94. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 7, 2026
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
Summary
Pre-stages T-7.3 (README v1 rewrite) + T-7.4 (STATE.md refresh) in parallel with Eng B's T-7.1 docs sweep (which just merged as #145). Independence-checked: no overlapping paths.
Files
Drafted
Marked draft because baton is currently `S2` (Eng B's window — they shipped T-7.1, T-7.2 baton-flip pending). Will mark ready when baton flips back.
Coordination
Verified no overlap with Eng B's T-7.1 (#145):
Already rebased onto release/v1.0 post-#145; force-pushed clean.
Defer to v1.0.x
Per PLAN T-7.3, full clear-admin command reference + integration guides (Astro/React/SDK) + REST docs are listed. Splitting those out as a v1.0.x doc patch — they're additive and don't gate the v1.0.0 stamp. Will file as issue.
🤖 Generated with Claude Code