You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Don't include version heading in GitHub Release notes (redundant with release title)
- Omit 'Other changes' subheading when there are no highlighted features above it
- Add 'New contributors' section listing first-time contributors with their PR link
Co-authored-by: Copilot <[email protected]>
Copy file name to clipboardExpand all lines: .github/workflows/release-changelog.md
+16-3Lines changed: 16 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -70,17 +70,25 @@ Separate the changes into two groups:
70
70
71
71
Only include changes that are **user-visible in the published SDK packages**. Skip anything that only affects docs, CI, build tooling, GitHub workflows, test infrastructure, or other internal-only concerns.
72
72
73
+
Additionally, identify **new contributors** — anyone whose first merged PR to this repo falls within this release range. You can determine this by checking whether the author has any earlier merged PRs in the repository.
74
+
73
75
### Step 4: Update CHANGELOG.md
74
76
75
77
1. Read the current `CHANGELOG.md` file.
76
78
2. Add the new version entry **at the top** of the file, right after the title/header.
77
79
78
80
**Format for each highlighted feature** — use an `### Feature:` or `### Fix:` heading, a 1-2 sentence description explaining what it does and why it matters, and at least one short code snippet (max 3 lines). Focus on **TypeScript** and **C#** as the primary languages. Only show Go/Python when giving a list of one-liner equivalents across all languages, or when their usage pattern is meaningfully different.
79
81
80
-
**Format for other changes** — a single `### Other changes` section with a flat bulleted list. Each bullet has a lowercase prefix (`feature:`, `bugfix:`, `improvement:`) and a one-line description linking to the PR.
82
+
**Format for other changes** — a single `### Other changes` section with a flat bulleted list. Each bullet has a lowercase prefix (`feature:`, `bugfix:`, `improvement:`) and a one-line description linking to the PR.**However, if there are no highlighted features above it, omit the `### Other changes` heading entirely** — just list the bullets directly under the version heading.
81
83
82
84
3. Use the release's publish date (from the GitHub Release metadata), not today's date. For `workflow_dispatch` runs, fetch the release by tag to get the date.
83
-
4. Make sure the existing content below is preserved exactly as-is.
85
+
4. If there are new contributors, add a `### New contributors` section at the end listing each with a link to their first PR:
86
+
```
87
+
### New contributors
88
+
- @username made their first contribution in [#123](https://github.com/github/copilot-sdk/pull/123)
89
+
```
90
+
Omit this section if there are no new contributors.
91
+
5. Make sure the existing content below is preserved exactly as-is.
84
92
85
93
### Step 5: Create a Pull Request
86
94
@@ -90,7 +98,7 @@ Use the `create-pull-request` output to submit your changes. The PR should:
90
98
91
99
### Step 6: Update the GitHub Release
92
100
93
-
Use the `update-release` output to replace the auto-generated release notes with your nicely formatted changelog (same content you put in CHANGELOG.md, minus the header).
101
+
Use the `update-release` output to replace the auto-generated release notes with your nicely formatted changelog. **Do not include the version heading** (`## [vX.Y.Z](...) (date)`) in the release notes — the release already has a title showing the version. Start directly with the feature sections or other changes list.
94
102
95
103
## Example Output
96
104
@@ -130,6 +138,11 @@ While `session.rpc.models.setModel()` already worked, there is now a convenience
130
138
- improvement: **[C#]** use event delegate for thread-safe, insertion-ordered event handler dispatch ([#624](https://github.com/github/copilot-sdk/pull/624))
131
139
- improvement: **[C#]** deduplicate `OnDisposeCall` and improve implementation ([#626](https://github.com/github/copilot-sdk/pull/626))
0 commit comments