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 #941

Merged
merged 1 commit into from
Nov 1, 2019
Merged

Conversation

rymai
Copy link
Member

@rymai rymai commented Oct 31, 2019

Similarly to guard/listen#466.

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

Signed-off-by: Rémy Coutable <remy@rymai.me>
@rymai rymai added the 🏠 Housekeeping Non-user facing cleanup and maintenance label Oct 31, 2019
@rymai rymai self-assigned this Oct 31, 2019
@rymai rymai merged commit a9cbc40 into master Nov 1, 2019
@rymai rymai deleted the set-up-release-drafter branch November 1, 2019 00:17
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.

1 participant