- Update
CHANGELOG.md
with the changes since the last release. Consider automating with a command such as these two:git log $(git describe --tags --abbrev=0)..HEAD --no-merges --oneline > new-in-this-release.log
git log --pretty='%C(green)%d%Creset- %s | [%an](https://github.com/)'
- Update VersionPrefix (and VersionSuffix if necessary) in the
*.csproj
files- If updating the OTel SDK, update the OTLP version in
HoneycombOptions.cs
- If updating the OTel SDK, update the OTel version in
README.md
- If updating the OTel SDK, update the OTLP version in
- Commit changes, push, and open a release preparation pull request for review.
- Once the pull request is merged, fetch the updated
main
branch. - Apply a tag for the new version on the merged commit (e.g.
git tag -a v1.3.0 -m "v1.3.0"
)- Note: We only tag the main package (even if changes were made to the instr packages) so the pipeline doesn't double-run
- Push the tag upstream (this will kick off the release pipeline in CI) e.g.
git push origin v1.3.0
- Ensure that there is a draft GitHub release created as part of CI publish steps (this will also publish to Nuget).
- Click "generate release notes" in Github for full changelog notes and any new contributors
- Publish the Github draft release - if it is a prerelease (e.g. beta) click the prerelease checkbox.