Skip to content

docs: reconcile with v3.0.0–v3.2.0 reality (README, CHANGELOG backfill, FONTS recipe, DEPLOYMENT) - #397

Merged
genwave-radio merged 1 commit into
mainfrom
docs/reconcile-v3.2.0
Aug 7, 2026
Merged

docs: reconcile with v3.0.0–v3.2.0 reality (README, CHANGELOG backfill, FONTS recipe, DEPLOYMENT)#397
genwave-radio merged 1 commit into
mainfrom
docs/reconcile-v3.2.0

Conversation

@genwave-radio

Copy link
Copy Markdown
Collaborator

📚 What

/document reconciliation after the theming epoch (v3.0.0 → v3.2.0). Drift was audited docs-vs-code across the repo; every concrete DEPLOYMENT.md value checked against the compose files came back ✓ (tools/check-doc-drift.sh green before and after) — the fixes below are the prose that had fallen behind.

  • README — the theming epoch existed nowhere: added the wardrobe paragraph (themes + switchers v3.0.0, multi-kind Community Catalog, Wardrobe page v3.1.0, /editor + save-as-own + guarded uninstall v3.2.0); "Persona Catalog" → Community Catalog; db/ range 02..32; engine pin correctly attributed to engine/Dockerfile; the --pinned no-rollback nuance (README previously claimed unconditional rollback).
  • CHANGELOG — backfilled the two missing entries per Dean's ruling: v3.1.1 (wardrobe polish, gh-Theme catalog detail: no installed-state or provenance (parity with the font-pack polish) #375, the /wardrobe naming ruling) and v3.2.0 (F104 M2: widened font law, editor, save-as-own behind ThemeWriteGate with the fail-closed 409, in-statement uninstall guard, disclosure re-audit).
  • FONTS.md — §3 recipe now carries --name-IDs='*' (the revision that shipped with Space Grotesk); the old "known limitation" paragraph reframed — the one open item (re-subsetting the five original vendored faces for OFL-record parity) is explicitly flagged as a /design decision, not decided here; enforcement section documents the T205 vendored ∪ installed widening and all three write-path call sites.
  • DEPLOYMENT — the two stale theme paragraphs ("switchers are unbuilt", "one-option dropdown, changes nothing visible") rewritten to the shipped truth. Every other value in the file verified current.

🚩 Flagged, not decided (owed to /design)

  • F99 "the deleted default" — designed, never built, contested by the Pi/piper-only work.
  • OFL-record re-subset of the five original vendored faces.

(ARCHITECTURE.md/MEMORY.md updates were made in the local planning corpus, which doesn't ship.)

…NGELOG backfill, FONTS recipe, DEPLOYMENT theme prose)
@genwave-radio
genwave-radio merged commit 0e7b7c7 into main Aug 7, 2026
11 checks passed
@genwave-radio
genwave-radio deleted the docs/reconcile-v3.2.0 branch August 7, 2026 19:53
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant