Skip to content

docs(skill): fold v0.3.0 release learnings into the release-manager skill - #2548

Open
fengmk2 wants to merge 1 commit into
mainfrom
docs/release-manager-v030-learnings
Open

docs(skill): fold v0.3.0 release learnings into the release-manager skill#2548
fengmk2 wants to merge 1 commit into
mainfrom
docs/release-manager-v030-learnings

Conversation

@fengmk2

@fengmk2 fengmk2 commented Aug 24, 2026

Copy link
Copy Markdown
Member

Folds the durable learnings from the v0.3.0 release into the release-manager skill.

Registry visibility after npm publish. pnpm publish prints ✅ Published package <name>@X.Y.Z when the registry accepts the request, not when it serves the version. In v0.3.0 the Release job went green, but @voidzero-dev/vite-plus-core@0.3.0 stayed invisible for about 35 minutes while vite-plus@0.3.0 was already on the latest tag depending on it. Every install failed with ETARGET, and the Docker and docs jobs failed too. Step 7 now adds a cache-busting visibility check between publish and the downstream jobs, with the rollback command and a real temp-dir install to confirm.

Changelog rules. Docs covers the published docs site, so a docs commit touching an RFC, AGENTS.md, or a skill goes in Chore. Entries describe behaviour, not resolution logic. A breaking change states its migration path.

Smaller corrections. Drop the Release vite-plus vX.Y.Z: ... opener from the body template, since it duplicated the PR title and step 8 stripped it again. Hand the Discord draft over in chat instead of commenting it on the release PR.

…kill

Adds a registry-visibility gate after npm publish. A green Release job only means the registry accepted the request; v0.3.0 shipped with vite-plus on latest depending on a core version that stayed invisible for about 35 minutes, breaking every install and failing the Docker and docs jobs.

Also drops the PR-title opener from the body template, records that Docs covers the published site rather than contributor files, keeps resolution logic out of entries, requires a migration path on breaking changes, and stops posting the Discord draft to the release PR.
@netlify

netlify Bot commented Aug 24, 2026

Copy link
Copy Markdown

Deploy Preview for viteplus-preview canceled.

Name Link
🔨 Latest commit 54f70dd
🔍 Latest deploy log https://app.netlify.com/projects/viteplus-preview/deploys/6a8bd2fb7d701d00089e5f91

@fengmk2
fengmk2 requested a review from wan9chi August 24, 2026 05:15
@fengmk2 fengmk2 self-assigned this Aug 24, 2026
@fengmk2
fengmk2 marked this pull request as ready for review August 24, 2026 05:15
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