Skip to content

Maintainer notes: number the npm publish-verify substeps - #2786

Open
chalin wants to merge 3 commits into
google:mainfrom
chalin:chalin-m24-notes-step15-substeps-2026-0902
Open

Maintainer notes: number the npm publish-verify substeps#2786
chalin wants to merge 3 commits into
google:mainfrom
chalin:chalin-m24-notes-step15-substeps-2026-0902

Conversation

@chalin

@chalin chalin commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator
  • Numbers step 15's four sequential gates (approve, check, re-point next, vet), with a lead-in telling release trackers to box each gate individually: the 0.17.0 run carried the step as one box, which hid that the next re-point was still pending after the publish landed
  • Adds the missing final gate: vet the published artifact with the registry smoke run, release-pinned — an independent review of this PR caught that the suite's default bare @docsy/theme install false-greens under min-release-age (the 0.17.0 vet had smoke-tested 0.16.0); the pinned form re-run green against 0.17.0 (6/6, installed version verified)
  • The manual-publish and broken-CI bullets stay unnumbered under an "Exceptions to the CI flow" lead: they're alternates, not sequence gates
  • Preview: Publishing a release § step 15

@chalin chalin added this to the 0.18.0 milestone Sep 2, 2026
- Numbers step 15's four sequential gates (approve, check, re-point next, vet) so release trackers box each individually: the 0.17.0 run carried them as one box, hiding which gates remained
- Adds the missing final gate: vet the published artifact via the registry smoke run (exercised manually on 0.17.0)
Review finding (confirmed live): under min-release-age, the suite's bare @docsy/theme install silently resolves the previous eligible stable, so an unpinned run false-greens the vet; the 0.17.0 run installed 0.16.0.
@chalin
chalin force-pushed the chalin-m24-notes-step15-substeps-2026-0902 branch from f4c2963 to 6d7cc94 Compare September 2, 2026 10:45
- Cross-links the update guide's release-age trap instead of restating it; drops suite mechanics (smoke.mjs owns them) and the 0.17.0 history (PR record)
- Front-loads the action and replaces the ambiguous "from main at the tag" with $BASE
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