Skip to content

docs(skill): refine release-manager guidance from the v1.3.0 release - #3084

Open
fengmk2 wants to merge 1 commit into
mainfrom
docs/skill-release-manager-v1.3.0
Open

fengmk2 wants to merge 1 commit into
mainfrom
docs/skill-release-manager-v1.3.0

Conversation

@fengmk2

@fengmk2 fengmk2 commented Oct 16, 2026

Copy link
Copy Markdown
Member

Fold the v1.3.0 release lessons into the release-manager skill.

  • Changelog structure: drop the separate Highlights section. Headline capabilities and security fixes lead Features, and the upstream upgrade entry stays last. The Discord format keeps its Highlights block.
  • Release notes: add a fixed "Create a New App" section after Installation with the pnpm create vite-plus example.
  • Advisories: cite only published advisories. A draft advisory visible through maintainer access is still embargoed, so it stays out of the notes and the announcement.
  • RustSec failures: check open Renovate PRs before opening a fix, since one may already bump the crate.
  • First publish of a new npm package: confirm the package has a trusted publisher for release.yml and the release environment before merging. Without it, the publish fails with ERR_PNPM_AUTH_TOKEN_EXCHANGE ... (status code 404) after vite-plus is already on latest, and the GitHub release, Docker image, docs deployment, and Discord notification are skipped.
  • Partial Release failures: use "Re-run failed jobs", never "Re-run all jobs". A full rerun repeats check, which then sees the new version on latest and skips the release. Publishing is idempotent, so a failed-jobs rerun uploads only what is missing. Whoever starts the rerun cannot approve it.
  • Post-release checks: use --prefer-online when a fresh version reports ETARGET locally. pnpm 11 and later default to a one-day minimumReleaseAge, so pnpm create vite-plus resolves to the previous create-vite-plus for a day after publishing.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-skill-release-manager-v1-3-0-viteplus-dev.voidzero-docs.workers.dev (commit 7c6e94a)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://6b435faa-viteplus-dev.voidzero-docs.workers.dev 7c6e94a 2026-10-16T06:36:15.636Z Visit the dashboard ↗

@fengmk2
fengmk2 requested a review from wan9chi October 16, 2026 06:37
@fengmk2 fengmk2 self-assigned this Oct 16, 2026

This branch has not been deployed

No deployments
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