Categorize GitHub Repository Release Notes by Content for a Nice Look | okaryo.log

Categorize GitHub Repository Release Notes by Content for a Nice Look



When creating release notes in a GitHub repository, you can click the “Generate release notes” button in the top right corner to automatically input the changes made since the last release.

Generate Release Note

This is already quite useful, but with just a little additional configuration, you can categorize these changes by content, which I will introduce here.


1. Create a configuration file

Create a .github/release.yml file with the settings for how to categorize the release notes.

The official documentation for configuration options is available here:

For reference, here’s the configuration I created:

      - ignore-for-release

    - title: 🎉 Feature
        - Feature
    - title: 🐛 Bug
        - Bug
    - title: 🔥 Remove
        - Remove
    - title: ⚡ Performance
        - Performance
    - title: ♻ Refactoring
        - Refactoring
    - title: ✅ Testing
        - Testing
    - title: 💚 CI/CD
        - CI/CD
    - title: ⬆ Dependencies
        - Dependencies
    - title: 🔒 Security
        - Security
    - title: 🛠 Development
        - Development
    - title: 📝 Documentation
        - Documentation
    - title: Other Changes
        - "*"

When creating release notes, if there are merged Pull Requests with labels corresponding to the labels setting in the difference since the last release, the release notes content will be categorized under the corresponding title category name.

I might have created too many categories for my first attempt at categorization, and I’m not sure if I’ve covered everything, but for now, I’ll try to operate with the above settings and make changes as needed to make it more user-friendly.

By the way, I referred to @azu’s github-label-setup repository when creating the labels.

2. Add labels to Pull Requests according to the settings

The configuration is now complete, so all you need to do is add labels to Pull Requests according to their content.

3. Click the “Generate release notes” button when creating release notes

After merging a few Pull Requests and creating release notes, clicking the “Generate release notes” button as mentioned above will display release notes categorized by content like this!

Release Note


While it’s nice to have more readable release notes, adding labels to Pull Requests is a bit of a hassle!

I usually add labels to issues, so adding them to Pull Requests as well is cumbersome. In my mind, Pull Requests are related to issues, so adding labels to both issues and Pull Requests feels redundant.

I usually link the corresponding issue to the “Development” section of the Pull Request, and when the Pull Request is merged, the issue is automatically closed. I was hoping to find a way to automatically add the same labels from the linked issue to the Pull Request when linking it to the “Development” section, but I couldn’t find such a trigger (if anyone knows, please let me know).



For now, I plan to manually add labels to Pull Requests as I create them, but I might improve this process if I find a better way.

In any case, this method makes the release notes easier to read, and I highly recommend giving it a try.

Related Posts
Related Posts

This site uses Google Analytics.