Skip to content

docs(release): #134 consolidated validation dossier + gate checklist + README snippet - #526

Merged
jsboige merged 1 commit into
masterfrom
docs/134-release-validation-dossier
Jun 17, 2026
Merged

docs(release): #134 consolidated validation dossier + gate checklist + README snippet#526
jsboige merged 1 commit into
masterfrom
docs/134-release-validation-dossier

Conversation

@jsboige

@jsboige jsboige commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

What

#134 consolidated release validation dossier — single entry-point indexing the scattered release docs + the two net-new pieces that were missing (gate checklist + README download snippet). Closes the "#134 structure dossier release" item (ai-01 deep-queue, non-gated). The release itself stays gated — no tag, no regen, no README edit.

The problem this solves

The release documentation was already substantial but scattered across 4 locations (CHANGELOG at root, validation-brief, QA scenario, DNN validation-checklist). A reader (jsboige) had no single map. This dossier is that map.

Net-new value (does NOT duplicate the indexed docs)

  1. Release-doc map (§2) — one index table pointing to all 4 existing docs.
  2. Per-language artifact matrix (§3) — grounded from the built Release bin: 8 langs × 8 PDF types = 64 PDFs, parity verified fr↔zh. Names the exact 8 types + per-type risk.
  3. Release-tag gate checklist (§4) — the tag-time contract (artifacts built, tests green, CSV 100%, visual QA, mindmap scope decided, changelog finalized, packaging plan, DNN coupling). Distinct from the DNN validation-checklist.
  4. README download-section snippet (§5) — issue release: Publish new GitHub release with updated game materials #134 explicitly asks for download links; README has none today. Provided gate-ready (NOT pasted — jsboige call at tag time) so the release-ready README is one paste away.

Flags for jsboige (decision-relevant)

Path note

Placed in docs/release-dossier/ (not docs/release/) because .gitignore:6 rule [Rr]elease/ excludes any directory named release/Release (build-output guard). Documented in the file.

Gate boundaries

  • ❌ No tag, no GitHub Release, no regen. ❌ No README.md / CHANGELOG.md edit (snippet provided, not applied). ❌ No QA verdict (ai-01 only). Pure framework doc, gated jsboige for the actual release.

🤖 Generated with Claude Code

…+ README snippet

Closes the "#134 structure dossier release" item (ai-01 deep-queue, non-gated).
The release docs were substantial but scattered across 4 locations; this is the
single consolidated entry point jsboige asked the worker to build, plus the two
net-new pieces that were missing.

Net-new value (does not duplicate the indexed docs):
- Release-tag gate checklist (§4) — distinct from the DNN validation-checklist;
  the tag-time contract (artifacts built, tests green, CSV 100%, visual QA,
  mindmap scope decided, changelog finalized, packaging plan, DNN coupling).
- README download-section snippet (§5) — issue #134 explicitly asks; README has
  none today. Provided gate-ready, NOT pasted (jsboige call at tag time).
- Per-language artifact matrix (§3) grounded from the built Release bin:
  8 langs x 8 PDF types = 64 PDFs, parity verified fr<->zh.

Indexes (not duplicates): CHANGELOG.md (root), release-v0.9.0-validation-brief.md,
qa-scenario-8langues-release.md, dnn-localization/release-validation/.

Flags: issue #134 body is STALE (says "4 langs", deps #127-#130) vs live 8-lang
scope. CHANGELOG test figure stale (155 vs ~359). MindMap es/ar/fa/zh blocked
(foreground-lock) = release-blocking scope decision for jsboige.

Placed in docs/release-dossier/ (not docs/release/) because .gitignore line 6
`[Rr]elease/` excludes any dir named release/Release (build-output guard).

No tag, no release, no regen, no README/CHANGELOG edit. Pure framework doc.
Gated jsboige for the actual release.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@clusterManager-Myia

Copy link
Copy Markdown
Collaborator

[NanoClaw] — LGTM

  • Release dossier for release: Publish new GitHub release with updated game materials #134: consolidated index of scattered docs, gate checklist, artifact inventory (8 langs x 8 PDFs = 64 PDFs)
  • Correctly notes stale issue body, gitignore path workaround, MindMap SVG blocking gap
  • GATED: no tag/release until jsboige approval
  • Docs only, no prod mutation

No concerns.

@jsboige
jsboige merged commit 132ffea into master Jun 17, 2026
3 checks passed
@jsboige
jsboige deleted the docs/134-release-validation-dossier branch June 17, 2026 23:08
jsboige added a commit that referenced this pull request Jun 19, 2026
…x new arc docs (#550)

Refresh the v0.9.0 release dossier so it is presentation-ready for
jsboige. Targeted staleness fix, not a rewrite (+16/-4).

- Header: refreshed date/base (master 4dd3c6b) + refresh-note block
  documenting the 3 corrections
- §2 doc-map: index the 3 new DNN upgrade-arc docs that merged since
  #526 (#531 target revision 10.3.2, #543 2sxc migration plan Phase 1.5,
  #548 DNN Phase 2 exec+rollback) — relevant to the "coupled DNN" release
- §4 gate checklist: the DNN #131 point said "10.1.2 vs 10.3.2
  undecided" — that is now confirmed 10.3.2 + 2sxc 21 (decision #2,
  #531); updated to reflect the decision + point to the procedure docs
- Artifact inventory re-verified against disk: 64 PDFs (8 langs × 8
  types) still present, mindmaps es/ar/fa/zh still 0 (foreground-lock)

No structural change. No tag, no release, no regen, no README/CHANGELOG
edit. Gated jsboige for the actual release.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants