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

[DX Streamline] Build CHANGELOG incrementally #12069

Closed
BigLep opened this issue Jun 5, 2024 · 0 comments · Fixed by #12191
Closed

[DX Streamline] Build CHANGELOG incrementally #12069

BigLep opened this issue Jun 5, 2024 · 0 comments · Fixed by #12191
Milestone

Comments

@BigLep
Copy link
Member

BigLep commented Jun 5, 2024

Problem to solve

When performing a Lotus a release, a non-trivial amount of time is spent at the end assembling, coalescing, and editorializing the CHANGELOG/release notes. The problem with this is:

  1. It often taking a non-trivial amount of time
  2. Usually the team isn't early or ahead of schedule when it starts the release process, so this non-trivial variable at the end is either stressful and/or becomes a blocking/delaying step of the release.
  3. The person attempting to do the release (e.g., "release engineer" like @rjan90) isn't always close to all the development work to properly summarize and highlight changes.

Why Important

If the project has goals of releasing more frequently while still keeping a high quality level (as discussed in #12020), then it helps to have more predictability, especially at the end of the development cycle.

User/Customer

Lotus maintainers

Notes

Idea: ipfs/kubo took the path of requiring a changelog update with each PR by default (although there are self-service ways to opt out of this for a given PR). See ipfs/boxo#398 . This had the benefit of:

  1. Build the changelog incrementally
  2. Have the subject matter experts help document since they are mostly likely best positioned to highlight the importance or caveats of a certain change.
@rjan90 rjan90 added this to FilOz Jun 6, 2024
@rjan90 rjan90 moved this to 🐱Todo in FilOz Jun 6, 2024
@rjan90 rjan90 added this to the DX-Streamline milestone Jun 6, 2024
@BigLep BigLep moved this from 🐱Todo to 🎉 Done in FilOz Jul 9, 2024
@rjan90 rjan90 moved this from 🎉 Done to ☑️Done (Archive) in FilOz Jul 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: ☑️ Done (Archive)
Development

Successfully merging a pull request may close this issue.

2 participants