[PR #14728] When generating a stacked changelog, note which branch/es contain a commit #30238

Open
opened 2026-01-31 09:39:30 +00:00 by claunia · 0 comments
Owner

Original Pull Request: https://github.com/microsoft/terminal/pull/14728

State: closed
Merged: Yes


New-TerminalStackedChangelog used to generate logs that looked like this:

* [3] A commit that was seen 3 times
* A commit that was only seen once
* [2] Some other commit

Now it will generate logs that look like this:

   / base..branch-1
   |/ base..branch-2
   ||/ base..branch-3
* [XXX] A commit that was seen 3 times
* [ X ] A commit that was only seen once
* [XX ] Some other commit

This format is more expressive, as it indicates which branches contain which commits.

As a reminder, my release note writing style starts with a stacked changelog. It's how I tell (1) which commits are in the new preview release only, (2) which commits are in the new preview and the new stable release and (3) which commits were already released in a previous stable release.

Changes from 1 get included in the new changelog, changes from 2 get included in both and changes from 3 get deleted because they have already been released.

**Original Pull Request:** https://github.com/microsoft/terminal/pull/14728 **State:** closed **Merged:** Yes --- New-TerminalStackedChangelog used to generate logs that looked like this: ``` * [3] A commit that was seen 3 times * A commit that was only seen once * [2] Some other commit ``` Now it will generate logs that look like this: ``` / base..branch-1 |/ base..branch-2 ||/ base..branch-3 * [XXX] A commit that was seen 3 times * [ X ] A commit that was only seen once * [XX ] Some other commit ``` This format is more expressive, as it indicates _which branches_ contain which commits. As a reminder, my release note writing style starts with a stacked changelog. It's how I tell (1) which commits are in the new preview release only, (2) which commits are in the new preview and the new stable release and (3) which commits were already released in a previous stable release. Changes from 1 get included in the new changelog, changes from 2 get included in both and changes from 3 get deleted because they have already been released.
claunia added the pull-request label 2026-01-31 09:39:30 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#30238