chore: generate changelog based on conventional commits - #5487
Merged
Conversation
Contributor
Performance Report鉁旓笍 no performance regression detected Full benchmark results
|
nflaig
commented
May 12, 2023
| /** | ||
| * @type {Record<string, {heading: string; commitsByScope: Record<string, string[]>}>} | ||
| */ | ||
| const sections = { |
Member
Author
There was a problem hiding this comment.
Looking for feedback on what sections, headings and ordering we want to use here.
| continue; | ||
| } | ||
|
|
||
| const [, type, scope, _breaking, subject] = conventionalCommit; |
Member
Author
There was a problem hiding this comment.
Breaking changes are not highlighted at the moment, possible solution could be to have an extra section ## Breaking Changes but based on how we used ! so far this would be too noisy as there are too many changes marked as breaking which are not user facing.
I think if we can restrain breaking commits as highlighted by ! to user facing changes it would be valuable as it provides a quick way for operators (or other downstream tooling) to just check this section to know if they are affected by any of the introduced changes.
Potential solutions to highlight breaking changes
- separate Section (
## Breaking Changes) - prefixing or suffixing line (
**BREAKING CHANGE:**or[BREAKING]) - using some kind of emoji at beginning of the line (
鈿狅笍 )
Member
There was a problem hiding this comment.
I have no strong opinion to either method. However as you already mentioned, we do have a lot of breaking changes which isn't necessarily useful to a non-developer user/operator of Lodestar. If it does affect a user, it'll likely be highlighted already on my manual summaries.
Member
Author
There was a problem hiding this comment.
Let's not highlight breaking changes in the Changelog for now, until we have more clarity on it. Updated description of #5433 to discuss it there.
wemeetagain
previously approved these changes
May 15, 2023
| /** | ||
| * @type {Record<string, {heading: string; commitsByScope: Record<string, string[]>}>} | ||
| */ | ||
| const sections = { |
matthewkeil
reviewed
May 15, 2023
matthewkeil
reviewed
May 15, 2023
| }; | ||
|
|
||
| const isPrCommitRg = /\(#\d+\)/; | ||
| const conventionalCommitRg = /^([a-z]+)(?:\((.*)\))?(?:(!))?: (.*)$/; |
Member
There was a problem hiding this comment.
Thats pretty a pretty fancy regexp. Did this get pulled from somewhere? Perhaps we can unit test it but that feels silly honestly for a workflow script...
Found this thread and it had a a pretty cool one in it to support emojis.
Not something I feel strongly about but thought was worth a mention. I put my faith in your trusting hands sir
Member
Author
There was a problem hiding this comment.
Not in favor of adding tests for the script. I have verified that the output is correct.
As I also do not trust any regex, I created some test cases which I just executed locally.
a pretty cool one in it to support emojis
The regex allows emojis in the commit message itself. It is really not that strict, a more strict format will be enforced by the PR title checker.
Member
Author
There was a problem hiding this comment.
Added console logs to print out ignored commits (dc26df1), this should be sufficient for now to verify that the regex works and there are no false positives.
matthewkeil
reviewed
May 15, 2023
| const login = getCommitAuthorLogin(commitHash, authorEmail, authorName); | ||
|
|
||
| commitListStr += `- ${subject} (@${login})\n`; | ||
| const formattedCommit = `- ${scope ? `**${scope}:** ` : ""}${subject} (@${login})\n`; |
Member
There was a problem hiding this comment.
Very nice touch looking up the author login name!! Always great to provide visibility to contributors
Member
Author
There was a problem hiding this comment.
Yeah, it is pretty nice, can easily see contributors of a release. That was already there in our initial version and does not seem to be easily supported by any other tools like release-please or semantic-release which is another good reason besides added complexity to not introduce additional tooling (for now).
matthewkeil
previously approved these changes
May 15, 2023
matthewkeil
left a comment
matthewkeil
left a comment
Member
There was a problem hiding this comment.
Excellent work! A couple of really nice touches in there!
matthewkeil
approved these changes
May 16, 2023
Member
|
馃帀 This PR is included in v1.9.0 馃帀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
More structured and readable Changelog.
Part of #1773 and follow up to #5342 which already enforces conventional commit PR titles.
Description
Running the following command will produce this CHANGELOG.md
Related resources