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

Backport changelog improvements #36346

Merged
merged 10 commits into from
Jan 16, 2025
Merged

Conversation

DanielMSchmidt
Copy link
Contributor

Fixes #

Target Release

1.11.x

CHANGELOG entry

  • This change is user-facing and I added a changelog entry.
  • This change is not user-facing.

@DanielMSchmidt DanielMSchmidt requested a review from a team as a code owner January 16, 2025 11:39
radeksimko
radeksimko previously approved these changes Jan 16, 2025
Copy link
Member

@radeksimko radeksimko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but let's not merge this until the 1.11.0-beta1 release is completely finished. cc @SarahFrench

By changing the folder changie uses for the changelog we can
make sure that users can put the changelog entries into a specific
folder based on if the change will be backported. This way it will
only appear in the patch release of the maintenance branch and not
in the changelog of the current development branch.
1.11.0-beta1
1.11.0-dev
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What should this value be when doing post-release cleanup after 1.11.0-beta1? Should it be reverting this way? (Genuine question, not saying it's necessarily incorrect)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we don't care about the value besides from the point when we do the release.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Historically it has been set to the next release to be done, but I don't think it matters, right @radeksimko / @liamcervante ?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

...however, that probably doesn't matter as preparing the release branch for subsequent releases will update the VERSION value to the correct one: https://github.com/hashicorp/terraform-releases?tab=readme-ov-file#prepare-the-release-branch

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be great to keep some way of telling two binaries apart even when they're built outside of the usual release process, so technically dev suffix makes that harder because it merges all patch releases into one - i.e. anything custom built between 1.11.0-alpha and 1.11.0 (final) will become indistinguishable.

All that said it's not a great way of solving that problem anyway and I would much rather see us solving it e.g. by encoding revisions into the binary alongside the semver, like Vault, Boundary or Nomad do.

@SarahFrench
Copy link
Member

I confirmed with Radek that it's ok to merge this as post-release clean up. I just want to confirm that the cleanup done here is as expected and then I'm happy to merge

Copy link
Member

@SarahFrench SarahFrench left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving as it looks like any difference in post-release cleanup in this PR will be caught by other steps in the process (see: #36346 (comment))

By merging this I'm backporting the changelog generation changes but also effectively doing the post-release cleanup after releasing 1.11.0-beta earlier today

@SarahFrench SarahFrench merged commit af89f87 into v1.11 Jan 16, 2025
11 checks passed
@SarahFrench SarahFrench deleted the backport-changelog-improvements branch January 16, 2025 18:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants