Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve sections ordering #139

Merged
merged 2 commits into from
Sep 30, 2023
Merged

Improve sections ordering #139

merged 2 commits into from
Sep 30, 2023

Conversation

smortex
Copy link
Contributor

@smortex smortex commented Sep 28, 2023

In order to better match changes that follow semver, group changes that
trigger a MAJOR bump ("Changed", "Removed") before those that trigger
a MINOR bump ("Added"), before those that trigger a PATCH bump
("Fixed").

"Security", "Deprecated" and "Other" changes do not have a corresponding
part as far as semver is concerned, so put them where it makes more
sense: "Security" at the top, "Deprecated" just after "Removed" and
"Other" at the end.

The ordering is now:

  • Security
  • Changed
  • Removed
  • Deprecated
  • Added
  • Fixed
  • Other

In order to better match changes that follow semver, group changes that
trigger a MAJOR bump ("Changed", "Removed") _before_ those that trigger
a MINOR bump ("Added"), _before_ those that trigger a PATCH bump
("Fixed").

"Security", "Deprecated" and "Other" changes do not have a corresponding
part as far as semver is concerned, so put them where it makes more
sense: "Security" at the top, "Deprecated" just after "Removed" and
"Other" at the end.

The ordering is now:
  - Security
  - Changed
  - Removed
  - Deprecated
  - Added
  - Fixed
  - Other
@chelnak
Copy link
Owner

chelnak commented Sep 28, 2023

Looks good! Thank you for the improvement. 🙏

Did you get chance to test it? If not I can validate a bit later and cut a release.

The reordering cause extra new lines to be output in existing
changelogs.

Make the template consistent accross each section to fix the issue.
@smortex
Copy link
Contributor Author

smortex commented Sep 28, 2023

@chelnak I added a commit to fix some inconsistency in the template that caused changes when generating the changelog for the project itself. It now produce the same changelog as before.

I also tried it on the puppetlabs-apache module and the new changelog only change by section ordering as expected.

@chelnak chelnak merged commit 03a3dd9 into chelnak:main Sep 30, 2023
1 check passed
@chelnak
Copy link
Owner

chelnak commented Sep 30, 2023

Thank you! I will cut a new release later today.

@smortex smortex deleted the reorder-sections branch September 30, 2023 20:16
@chelnak chelnak added the enhancement New feature or request label Oct 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants