LearnNewsExamplesServices
Frontmatter
id14555
titlev13.1 notes cut-prep: banner removal + TD diagrams + stamped counts
stateClosed
labels
documentationenhancementai
assigneesneo-opus-vega
createdAtJul 3, 2026, 11:02 PM
updatedAtJul 3, 2026, 11:36 PM
githubUrlhttps://github.com/neomjs/neo/issues/14555
authorneo-opus-vega
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJul 3, 2026, 11:36 PM

v13.1 notes cut-prep: banner removal + TD diagrams + stamped counts

Closed v13.1.0/archive-v13-1-0-chunk-8 documentationenhancementai
neo-opus-vega
neo-opus-vega commented on Jul 3, 2026, 11:02 PM

Context

The final pre-publish notes pass (operator-directed, 2026-07-03): the release cannot run while the iteration banner sits in resources/content/release-notes/v13.1.0.md:7 ("iteration 2 of N — deliberately-early draft… Do not read as final"). Iterations 2 (PR #14530) and 3 (PR #14554, diagram layer) passed review; the remaining gap is cut-prep. Per the release-notes skill §7, banner removal is exactly the final-iteration job — this leaf executes it.

Live latest-open sweep at 2026-07-03T20:52Z: no equivalent (#14552 is the iteration-3 diagram AUTHORING leaf; this is the distinct cut-prep pass). Sequencing: depends on PR #14554 merging first — item 2 below edits the diagrams that PR introduces.

The Problem

Three cut-blockers:

  1. The iteration banner (line 7) — stale twice over: it blocks the release by design, and it still says "iteration 2 of N" although iteration 3 shipped.
  2. Both diagrams violate the render bar the substrate itself prescribes: guide-authoring-bar.md:32 — "flowchart TD, not LR for chains > ~5 nodes — LR lays them left-to-right, GitHub/portal scale-to-fit, and it becomes unreadable." The War Story loop is 6 nodes LR; the Golden Path route is 9 nodes LR (operator-observed: scaled down too much). Reviewer-miss on record: the bar sign-off verified content fidelity node-by-node but skipped the orientation check — the render-verify discipline exists for exactly this.
  3. The headline stat is a day stale and unstamped: the notes say 688 PRs / 778 issues / 8 epics; the live analyzer (2026-07-03, verified v13.0 cutoff 2026-03-27) reports 702 merged PRs / 794 closed issues / 9 epics closed (#11318 closed since). Per the #14530 review's requested item, the stat line carries its source + as-of so every future regeneration inherits the discipline.

The Fix

One PR on the flat-root staging file (sync-fenced branch naming):

  1. Remove the banner blockquote entirely (skill §7 final-iteration action).
  2. Flip both flowchart LRflowchart TD — content identical, orientation only, per the guide-authoring bar.
  3. Update + source-stamp the stat line and the changelog-shape counts from the live analyzer run (702 / 794 / 9; fix(ai) 143, docs(agentos) 46, feat(agentos) 21).
  4. Sweep for any other "iteration" references that imply non-final state.

Acceptance Criteria

  • Banner gone; no remaining draft/non-final designations in the file
  • Both diagrams flowchart TD; nodes/edges/labels byte-identical otherwise
  • Stat + changelog-shape lines match the analyzer output, with source + as-of stamped
  • Cross-family review before merge (release-blocking surface)
  • PR Resolves this leaf, Refs #14475 #14483

Out of Scope

  • The version bump + publish execution (operator-owned, #14475 / publish.mjs)
  • New content (the bar is passed for the minor-release precedent SET; the Body-chapter/digest/actionability items were calibrated against the v13.0 MAJOR and move to the v14 notes lane)

Related

Related: #14475 (cut leaf — this feeds it) · #14483 (notes epic) · #14552 / PR #14554 (diagram layer — merge dependency) · #14489 / PR #14530 (iteration 2)

Origin Session ID: 8cf234b7-e698-47ca-99e2-bf865196b6aa (continuation 233a6b21)

Retrieval Hint: v13.1 notes cut-prep banner removal TD mermaid orientation stamped counts

tobiu referenced in commit e06bcd5 - "docs(release): v13.1 notes cut-prep — banner out, TD diagrams, stamped counts (#14555) (#14556) on Jul 3, 2026, 11:36 PM
tobiu closed this issue on Jul 3, 2026, 11:36 PM