From 2d010715c909ca6e575e98e11581420fb815176a Mon Sep 17 00:00:00 2001 From: Alex Ross <38270282+alexr00@users.noreply.github.com> Date: Mon, 16 Mar 2026 12:48:11 +0100 Subject: [PATCH] Changelog for 0.132.1 --- .github/skills/write-changelog/SKILL.md | 74 +++++++++++++++++++++++++ CHANGELOG.md | 8 +++ 2 files changed, 82 insertions(+) create mode 100644 .github/skills/write-changelog/SKILL.md diff --git a/.github/skills/write-changelog/SKILL.md b/.github/skills/write-changelog/SKILL.md new file mode 100644 index 0000000000..86b597da2d --- /dev/null +++ b/.github/skills/write-changelog/SKILL.md @@ -0,0 +1,74 @@ +--- +name: write-changelog +description: 'Write a CHANGELOG.md entry for a new extension release. Use when: writing changelog, updating changelog, adding release notes, preparing a release, documenting milestone changes. Requires a milestone name and extension version number.' +argument-hint: 'Provide the extension version (e.g. 0.134.0) and the GitHub milestone name (e.g. 1.112.0)' +--- + +# Write Changelog Entry + +Generate a new entry in `CHANGELOG.md` for an extension release by gathering closed issues and merged PRs from a GitHub milestone. + +## Inputs + +The user must provide: +1. **Extension version number** - the version for the changelog heading (e.g. `0.134.0`) +2. **GitHub milestone name** - the milestone to query (e.g. `1.112.0`) + +## Procedure + +### 1. Gather Milestone Items + +Search for all closed items in the milestone scoped to `microsoft/vscode-pull-request-github`: + +- **Issues (bugs/features):** Search for closed issues with `milestone:"" repo:microsoft/vscode-pull-request-github is:closed` +- **Merged PRs:** Search for merged PRs with `milestone:"" repo:microsoft/vscode-pull-request-github is:pr is:merged` + +### 2. Classify Items + +Sort every item into one of these buckets: + +| Bucket | Criteria | +|--------|----------| +| **Changes** | Feature requests, enhancements, new settings, new commands, infrastructure improvements (e.g. dependency upgrades, build system changes) | +| **Fixes** | Items labeled `bug`, or PRs that fix a specific issue | +| **Thank You** | Merged PRs authored by external contributors (user type is not `Bot`, and user is not a GitHub staff / `site_admin`) | +| **Skip** | Version-bump PRs (title is just a version like "0.132.0"), test plan items, items from other repos | + +### 3. Write the Entry + +Insert the new section **at the top** of `CHANGELOG.md`, directly after the `# Changelog` heading and before the previous release section. + +Follow this format exactly: + +```markdown +## + +### Changes + +- Description of change one. +- Description of change two with setting `"settingName"`. + +### Fixes + +- Short description of bug. https://github.com/microsoft/vscode-pull-request-github/issues/ +- Another bug fix. https://github.com/microsoft/vscode-pull-request-github/issues/ + +**_Thank You_** + +* [@username (Display Name)](https://github.com/username): Short description of contribution [PR #1234](https://github.com/microsoft/vscode-pull-request-github/pull/1234) +``` + +### Format Rules + +- **Changes:** Write a concise, user-facing description. Do NOT link to issues. Use backticks for setting names and commands. Each entry is a single `- ` bullet. +- **Fixes:** Use the issue title (cleaned up for readability) followed by a space and the full issue URL. Each entry is a single `- ` bullet. If a fix came from a PR without a linked issue, describe it without a URL. +- **Thank You:** Use `* ` bullets (not `- `). Format: `[@login (Name)](profile-url): Description [PR #number](pr-url)`. Only include for external community contributors. +- **Sections:** Omit any section (`### Changes`, `### Fixes`, `**_Thank You_**`) if there are no items for it. +- **No blank lines** between bullets within a section. +- **One blank line** between sections. + +### 4. Validate + +- Confirm the new section is positioned correctly (after `# Changelog`, before the previous version). +- Verify all issue/PR links are correct and point to `microsoft/vscode-pull-request-github`. +- Ensure no duplicate entries. diff --git a/CHANGELOG.md b/CHANGELOG.md index 2be34e5728..a5799f39e1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 0.132.1 + +### Fixes + +- Can't add multiline GitHub PR Comment because Inline Chat button covers Comment button. https://github.com/microsoft/vscode-pull-request-github/issues/8504 +- Deleting a worktree after merging a PR mixes the main branch with the worktree. https://github.com/microsoft/vscode-pull-request-github/issues/8519 +- Missing issue webview icon. + ## 0.132.0 ### Changes