docs: deduplicate release checklist verification commands #41

New issue

Closed

opened 2026-03-13 22:57:59 +00:00 by pokebedrock-bot · 0 comments

pokebedrock-bot commented

2026-03-13 22:57:59 +00:00

(Migrated from github.com)

Summary\nThe wiki release checklist still tells maintainers to run all three of these before release:\n\n- `npm ci`\n- `npm run ci`\n- `npm run audit:prod`\n\nBut in this repo, `npm run ci` is already the canonical verification gate used by CI for content validation and generated-file drift, so the release checklist is currently over-prescriptive and makes the manual release path look different from the normal contributor path.\n\n## Impact\n- Maintainers may think a separate manual `npm run audit:prod` step is always required in addition to the normal validation gate.\n- The English and Spanish release checklists drift from the rest of the repo guidance that centers on `npm run ci`.\n- Future changes to validation commands are more likely to miss one of the duplicated checklist bullets.\n\n## Acceptance criteria\n- English and Spanish wiki release checklists describe `npm run ci` as the standard validation command.\n- The extra standalone `npm run audit:prod` checklist bullet is removed from both release-checklist docs.\n- Release guidance still keeps repo-specific search-index / sync checks intact.

## Summary\nThe wiki release checklist still tells maintainers to run all three of these before release:\n\n- `npm ci`\n- `npm run ci`\n- `npm run audit:prod`\n\nBut in this repo, `npm run ci` is already the canonical verification gate used by CI for content validation and generated-file drift, so the release checklist is currently over-prescriptive and makes the manual release path look different from the normal contributor path.\n\n## Impact\n- Maintainers may think a separate manual `npm run audit:prod` step is always required in addition to the normal validation gate.\n- The English and Spanish release checklists drift from the rest of the repo guidance that centers on `npm run ci`.\n- Future changes to validation commands are more likely to miss one of the duplicated checklist bullets.\n\n## Acceptance criteria\n- English and Spanish wiki release checklists describe `npm run ci` as the standard validation command.\n- The extra standalone `npm run audit:prod` checklist bullet is removed from both release-checklist docs.\n- Release guidance still keeps repo-specific search-index / sync checks intact.