Skip to content

Latest commit

 

History

History
23 lines (21 loc) · 1.53 KB

RELEASING.md

File metadata and controls

23 lines (21 loc) · 1.53 KB
Raw

Release procedure

v0.23.xx releases

  1. Check if there's a milestone for the release. Are we in a good state for the release? Are there any outstanding PRs that could be merged or should be waited for?
  2. Press the "Draft a new release" button in GitHub.
  3. Create a new tag with the appropriate name (e.g. v0.23.28); also name the release in GitHub accordingly.
  4. Make sure you're targeting the series/0.23 branch.
  5. Press the "Generate new release notes" button in GitHub.
  6. Manually edit the generated release notes:
    • Review the auto-labeling and categorization of PRs.
    • Put "Behind the scenes" section in to a details block.
    • Move any interesting or important behind the scenes PRs into the relevant categories. In particular, any bumps to public dependencies should be moved to the section for the relevant http4s module.
    • Just make it look nice :)
  7. Save the release as a draft.
  8. Copy the edited release notes into docs/changelog.md, at the top of the file.
    • Follow the same header style: "v0.23.xx (YYYY-MM-DD)".
  9. Create a branch and commit the changes to the changelog. Open a PR, and wait for tests to pass and for someone to approve.
  10. Merge the changelog PR.
  11. Now you're ready to release! Edit your draft release on GitHub and press the green "Publish Release" button.
  12. Wait for CI and publishing to finish, and then announce the release (mastodon, discord).
  13. Merge series/0.23 to main and open a PR.
    • There will likely be conflicts here that need working through. Don't be afraid to ask for help.