Skip to content

Automating release notes from CI #984

Open
@jalvesz

Description

@jalvesz

Motivation

I've been looking at ways to ease the generation of releases. I found two options that seems interesting:

  1. https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes#configuring-automatically-generated-release-notes
  2. https://git-cliff.org/ > https://git-cliff.org/docs/category/github-actions

I wanted to see if the use of any of these tools could help facilitate making more regular releases.

Any experience with these tools?

Prior Art

No response

Additional Information

No response

Activity

added
ideaProposition of an idea and opening an issue to discuss it
documentationImprovements or additions to documentation
help wantedExtra attention is needed
automationRelated to the workflows and automatic tests running here
on Apr 22, 2025
stigh

stigh commented on Apr 22, 2025

@stigh
Contributor

I think this is a great idea! To help keep the Git history clean and make changelog automation easier (especially with git-cliff), I’d suggest:

  1. Enabling squash-on-merge for the repo. This prevents intermediate commits from cluttering the history. It works best when PRs are kept small and focused.

  2. Adopting conventional commits (https://www.conventionalcommits.org/en/v1.0.0/), which git-cliff relies on for changelog generation. One approach is to use the conventional message as the PR title, since that becomes the final commit message after squashing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    automationRelated to the workflows and automatic tests running heredocumentationImprovements or additions to documentationhelp wantedExtra attention is neededideaProposition of an idea and opening an issue to discuss it

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      Automating release notes from CI · Issue #984 · fortran-lang/stdlib