Skip to content

docs(pivot): sweep tracking docs for wave-3/4 landings#212

Merged
trilamsr merged 1 commit into
mainfrom
pr-docs-sweep-wave-landings
May 31, 2026
Merged

docs(pivot): sweep tracking docs for wave-3/4 landings#212
trilamsr merged 1 commit into
mainfrom
pr-docs-sweep-wave-landings

Conversation

@trilamsr

Copy link
Copy Markdown
Contributor

Summary

Reconcile the four pivot-tracking docs (docs/rfcs/0013-distro-first-pivot.md, CHANGELOG.md, MILESTONES.md, docs/migration/v0.1-to-v0.2.md) with the wave-3 (PR-B1-shape sibling ports) and wave-4 (PR-B2-shape upstream-only ports + PR-F.1 + PR-J + PR-L + PR-N) landings. Pure doc sweep — no code or config touched.

What changed

docs/rfcs/0013-distro-first-pivot.md §migration

PR sequence rows updated with PR-number citations and landed markers:

CHANGELOG.md [Unreleased]

MILESTONES.md

docs/migration/v0.1-to-v0.2.md

  • §internal/* package deletion (PR-F) status flips from "not yet open" to "PR-F.1 landed (feat(pivot): PR-F.1 — delete internal moats (selftel/telemetry) + dcgm #206), PR-F.2 gated on three open ports".
  • Open-items checklist expanded from 5 to 13 entries — tracks every PR letter the migration guide cares about (A2 / E / F.1 / F.2 / I.1a-c / J / K.1-3 / L / N) with PR numbers and links.

Why now

Tracking docs accumulated drift across wave-3 + wave-4 because every sibling-port PR (and the support-infra PRs around them) updated the bottom of CHANGELOG.md but did not always touch the upstream sequencing section in RFC-0013. Per memory rule [Keeping this document current]: status drift is a review blocker. This PR is the consolidated catch-up; future port PRs include their RFC-row flip in-PR.

What this PR does NOT change

  • No code, no config, no YAML, no chart — only the four tracking docs.
  • No new doc gates added; existing gates pass.
  • No PRs other than the four named docs are modified.

Test plan

  • bash scripts/doc-check.sh clean (33 test refs, 528 links resolve, comment-noise diff gate clean vs origin/main, all 13 gates green).
  • Pre-commit hook (commitlint 72-char subject limit + DCO + AI-trailer gates) passed.
  • Pre-push hook (make ci-fast equivalent: golangci-lint, go vet, go mod verify, no-autoupdate-check, doc-check.sh) passed on second attempt after git fetch origin main populated the worktree's origin/main ref — first push failed because the worktree previously tracked the (gone) pr-a2-ocb-main-swap branch, so doc-check.sh's comment-noise diff-scope gate exited 128 on the missing ref. Root cause fixed by the fetch; not a workaround.
  • CI green on this branch.
NONE

Reconcile RFC-0013 + CHANGELOG + MILESTONES + migration guide with the wave-3
(PR-B1-shape sibling ports) and wave-4 (PR-B2-shape upstream-only ports +
PR-F.1 + PR-J + PR-L + PR-N) landings:

- docs/rfcs/0013-distro-first-pivot.md §migration: mark PR-A2 (#189), PR-B2
  (#201), PR-F.1, PR-G (#182), PR-H (#183), PR-L (#179 skeleton + #191 body),
  PR-N (#200) landed. Re-scope PR-F.2 to delete the whole internal/{component
  status,pipeline,pipelinebuilder,consumer,fanout,runtime/lifecycle} bundle in
  one cut once the three open ports (#204 / #205 / #207) land. Note PR-I.1a
  in flight, PR-I.1b gate satisfied by #201, PR-K.1 in flight. Record the
  wave-3-followup sibling ports (#202/#203/#208/#209) under PR-B2 to dispel
  the slug collision with #188's PR-B2-labelled dcgm port.
- CHANGELOG.md [Unreleased]: restructure the pivot wave list as four waves
  (was three) — wave 3 enumerates PR-B1-shape sibling ports + support infra
  (#180-#194/#196), wave 4 enumerates PR-B2-shape upstream-only ports +
  PR-J (#195) + PR-F.1 (#206) + PR-N (#200) + lint/TOCTOU hardening
  (#198/#210). Tighten the PR-F.2 deferred note to point at the three open
  ports as the gate.
- MILESTONES.md: M1 + M2 + M8 status rows now cite PR-A2/#189, PR-F.1/#206,
  PR-E/#180, PR-J/#195. M8 dcgm flipped to landed-and-replaced.
- docs/migration/v0.1-to-v0.2.md: §PR-F status flips from "not yet open" to
  "PR-F.1 landed, PR-F.2 gated on three open ports". Open-items checklist
  expanded to track every PR letter (A2 / E / F.1 / F.2 / I.1a-c / J / K.1-3
  / L / N) with PR numbers and links.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Signed-off-by: Tri Lam <tri@maydow.com>
@trilamsr trilamsr enabled auto-merge (squash) May 31, 2026 09:14
@trilamsr trilamsr merged commit d1094cc into main May 31, 2026
11 checks passed
@trilamsr trilamsr deleted the pr-docs-sweep-wave-landings branch May 31, 2026 09:14
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.

1 participant