Skip to content

Add release process documentation to Copilot instructions#441

Merged
nev21 merged 2 commits into
mainfrom
copilot/add-copilot-instructions
May 11, 2026
Merged

Add release process documentation to Copilot instructions#441
nev21 merged 2 commits into
mainfrom
copilot/add-copilot-instructions

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 11, 2026

The repository lacked documented conventions for how releases are created, leaving Copilot agents without guidance on the required commit format, file checklist, and CHANGELOG rules.

Changes

.github/copilot-instructions.md — added a ## Release Process section covering:

  • PR/commit title format: [Release] Increase version to X.Y.Z (required, no exceptions)
  • File checklist: all four package.json files (root, shared, ts-plugin, eslint-ts-plugin), both CHANGELOG.md files, root README.md, and common/config/rush/npm-shrinkwrap.json (regenerated via npm run rupdate)
  • @nevware21/grunt-plugins-shared-utils devDependency in ts-plugin/package.json and eslint-ts-plugin/package.json must also be bumped to the new version
  • CHANGELOG rules:
    • Prepend new # vX.Y.Z (Date) section with only significant changes; group minor dependency bumps into a single summary line
    • Always append [Full Release Details](https://github.com/nevware21/grunt-plugins/releases/tag/vX.Y.Z)
    • If an # Unreleased section already has items, carry them into the new version section as-is — do not remove or summarize them
  • Tag naming: GitHub releases use ts-plugin-X.Y.Z / eslint-ts-X.Y.Z; CHANGELOG links use vX.Y.Z
  • Publish scope: only @nevware21/grunt-ts-plugin and @nevware21/grunt-eslint-ts are published (shared has shouldPublish: false)

Copilot AI linked an issue May 11, 2026 that may be closed by this pull request
Copilot AI changed the title [WIP] Add copilot instructions and update release files Add release process documentation to Copilot instructions May 11, 2026
Copilot AI requested a review from nev21 May 11, 2026 05:16
Copilot finished work on behalf of nev21 May 11, 2026 05:16
@nev21 nev21 marked this pull request as ready for review May 11, 2026 05:52
@nev21 nev21 requested review from a team as code owners May 11, 2026 05:52
Copilot AI review requested due to automatic review settings May 11, 2026 05:52
@nev21 nev21 enabled auto-merge (squash) May 11, 2026 05:52
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds release-process guidance to the repository’s Copilot instructions so automated agents (and contributors) have a documented checklist for version bumps, Rush shrinkwrap regeneration, and CHANGELOG updates across the monorepo.

Changes:

  • Added a new “Release Process” section documenting the required PR/commit title format.
  • Documented a release file checklist (package.json version bumps, shared-utils devDependency bumps, CHANGELOG + README updates, and regenerating common/config/rush/npm-shrinkwrap.json via npm run rupdate).
  • Documented CHANGELOG update rules, including the required “Full Release Details” link.


(items added here after the release for the next version)

# vX.Y.Z (Month Dth, YYYY)
Comment on lines +224 to +231
### Release Tags

GitHub releases are tagged separately for each publishable package:
- `ts-plugin-X.Y.Z` for `@nevware21/grunt-ts-plugin` (e.g., `ts-plugin-0.5.2`)
- `eslint-ts-X.Y.Z` for `@nevware21/grunt-eslint-ts` (e.g., `eslint-ts-0.5.2`)

The `[Full Release Details]` link added to each package CHANGELOG conventionally uses the `vX.Y.Z` format (e.g., `https://github.com/nevware21/grunt-plugins/releases/tag/v0.5.2`) as a shared reference for the version, even though the per-package GitHub release tags use the `ts-plugin-X.Y.Z` / `eslint-ts-X.Y.Z` naming scheme.

Copy link
Copy Markdown
Contributor

@nevware21-bot nevware21-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved by nevware21-bot

@nev21 nev21 merged commit 7a644bd into main May 11, 2026
11 checks passed
@nev21 nev21 deleted the copilot/add-copilot-instructions branch May 11, 2026 06:30
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.

[Task] Onboard to copilot introducing instructions

4 participants