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

Add a workflow for external contributors to add a changelog entry #2944

Merged
merged 2 commits into from
Jan 8, 2025

Conversation

Madrigal
Copy link
Contributor

@Madrigal Madrigal commented Jan 6, 2025

Add instructions on how external contributors can add a .changelog entry. We've been taking over adding them in the past, but it'd be nice if contributors can do it themselves.

The workflow now would be

  1. Contributors would run make external-changelog
  2. They would have a file on .changelog/xxx.json that they would need to modify

Why external-changelog?

Because we internally use aws-go-multi-module-repository-tools. External contributors could use it too, but it's a bit too cumbersome to set it up for using only single time

Why not creating a uuid on behalf of contributors?

There's no built-in uuid tool that would work cross-platform

@Madrigal Madrigal requested a review from a team as a code owner January 6, 2025 20:32
@@ -484,6 +484,14 @@ set-smithy-go-version:
fi
go run ${REPOTOOLS_CMD_EDIT_MODULE_DEPENDENCY} -s "github.com/aws/smithy-go" -v "${SMITHY_GO_VERSION}"

external-changelog:
mkdir -p .changelog
cp changelog-template.json .changelog/00000000-0000-0000-0000-000000000000.json
Copy link
Contributor

Choose a reason for hiding this comment

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

I know you said x-platform concerns in the desc but I'm also fine with just calling uuid -v4 and letting people figure it out / do it manually otherwise.

{
"id": "00000000-0000-0000-0000-000000000000",
"type": "feature|bugfix|dependency",
"description": "Description of your changes",
Copy link
Contributor

Choose a reason for hiding this comment

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

do we need collapse here

Copy link
Contributor

Choose a reason for hiding this comment

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

The doc mentions it, don't think we need it here, but also a default of false would be fine.

@Madrigal Madrigal merged commit ef36115 into main Jan 8, 2025
13 checks passed
@Madrigal Madrigal deleted the feat-add-changelog-workflow branch January 8, 2025 15:52
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