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

Maintain release notes using GitHub Actions #466

Merged
merged 1 commit into from
Oct 8, 2019

Conversation

mattbrictson
Copy link
Contributor

This commit sets up a GitHub Actions workflow that uses Release Drafter to automatically maintain release notes on every push.

In practice this means that contributors no longer have to manually update the CHANGELOG, which is something that is easy to forget and often introduces tedious merge conflicts.

Instead, Release Drafter automatically adds the title of the PR to the GitHub release notes to a draft release, crediting the author of the PR, and linking to the PR number. Release Drafter furthermore organizes the release notes into sections according to the labels assigned to the PRs:

  • ⚠️ Breaking
  • 🐛 Bug Fix
  • 📚 Docs
  • ✨ Feature
  • 🏠 Housekeeping

This also simplifies the release process for maintainers: instead of manually updating the CHANGELOG, all you have to do is press "publish" on the release draft on GitHub.

As part of this commit I have documented the release process in README.md and the PR labeling process in CONTRIBUTING.md.

Before merging this PR a project administrator will need to create the following labels using this GitHub page:

Label name Description Color
⚠️ Breaking Introduces a backwards-incompatible change #d12d1b
🐛 Bug Fix Fixes a bug #c0fc80
📚 Docs Improves documentation #bfdadc
✨ Feature Adds a new feature #ba1ecc
🏠 Housekeeping Non-user facing cleanup and maintenance #ccccff

This commit sets up a GitHub Actions workflow that uses Release Drafter
to automatically maintain release notes on every push.

In practice this means that contributors no longer have to manually
update the CHANGELOG, which is something that is easy to forget and
often introduces tedious merge conflicts.

Instead, Release Drafter automatically adds the title of the PR to the
GitHub release notes to a draft release, crediting the author of the PR,
and linking to the PR number. Release Drafter furthermore organizes the
release notes into sections according to the labels assigned to the PRs:

- ⚠️ Breaking
- 🐛 Bug Fix
- 📚 Docs
- ✨ Feature
- 🏠 Housekeeping

This also simplifies the release process for maintainers: instead of
manually updating the CHANGELOG, all you have to do is press "publish"
on the release draft on GitHub.

As part of this commit I have documented the release process in
`README.md` and the PR labeling process in `CONTRIBUTING.md`.
@mattbrictson mattbrictson mentioned this pull request Oct 8, 2019
@coveralls
Copy link

coveralls commented Oct 8, 2019

Coverage Status

Coverage decreased (-0.1%) to 97.806% when pulling 6688153 on mattbrictson:chores/set-up-release-drafter into cd657cf on guard:master.

@ioquatix
Copy link
Member

ioquatix commented Oct 8, 2019

Okay lets try it!

@ioquatix ioquatix merged commit 896c74c into guard:master Oct 8, 2019
@ioquatix
Copy link
Member

ioquatix commented Oct 8, 2019

I can't seem to copy the icons in the text labels on Linux, is that a problem?

@mattbrictson mattbrictson deleted the chores/set-up-release-drafter branch October 8, 2019 21:01
@mattbrictson
Copy link
Contributor Author

We don't have to use the icons but the important part is that the label text must exactly match the label: listed in release-drafter.yml.

@rymai
Copy link
Member

rymai commented Oct 9, 2019

@mattbrictson Thanks! I've created the labels now!

@rymai rymai added the 🏠 Housekeeping Non-user facing cleanup and maintenance label Oct 9, 2019
@mattbrictson
Copy link
Contributor Author

Great! I am not a maintainer so I am not able to see the draft release notes. Is it working?

@mattbrictson
Copy link
Contributor Author

The draft release notes should show up at the top of this page: https://github.com/guard/listen/releases

@rymai
Copy link
Member

rymai commented Oct 11, 2019

@mattbrictson Yeah it worked but it prepared a draft for the v3.2.0 release which is already released, so I'll update them and publish them manually this time! Thanks again!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🏠 Housekeeping Non-user facing cleanup and maintenance
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants