Adopt external changelog generation tool

[kramaranya]

What you would like to be added?

We need to transition from our custom changelog generation script to an existing external tool for future releases.

For the first release, we'll keep using our current script so we don't delay anything. But for future releases, we should use either the Kubernetes release-notes CLI (that Kueue uses) or the git-cliff tool, (or any better solution you might find)

This might require some process changes like updating our PR template to include release notes sections, adding PR labels like kind/feature, kind/bug, etc.

Why is this needed?

We don't want to keep maintaining our own changelog script when there are good tools already available that other projects maintain

Love this feature?

Give it a 👍 We prioritize the features with most 👍

[kramaranya]

/remove-lifecycle stale
/remove-label lifecycle/needs-triage
/good-first-issue

cc @kubeflow/kubeflow-sdk-team

[google-oss-prow]

@kramaranya:
This request has been marked as suitable for new contributors.

Please ensure the request meets the requirements listed here.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-good-first-issue command.

In response to this:

/remove-lifecycle stale
/remove-label lifecycle/needs-triage
/good-first-issue

cc @kubeflow/kubeflow-sdk-team

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[jaiakash]

Hi @kramaranya I was checking out git-diff for generating changelog. These are few once i tried with minimal modification to cliff.toml file.

Example default: https://github.com/jaiakash/sdk/blob/add-git-cliff/CHANGELOG.md
Example 2 Github: https://github.com/jaiakash/sdk/blob/96a9746768ac77ed8d6981344edb5ffa762bf3c3/CHANGELOG.md

Few of changelog example of other projects which I liked

• https://github.com/GoogleCloudPlatform/kubectl-ai/releases/
• https://github.com/processing/processing4/releases
• git-cliff's own changelog https://github.com/orhun/git-cliff/releases

I think we do have to customize the cliff.toml based on our projects, but we can git-cliff to automating our changelog generation process.

[kramaranya]

Hey @jaiakash! Thanks for looking into this.

Ideally, we would like to get something close to what we currently have in our CHANGELOG, where we list PRs sorted by type.

git-cliff looks close to what we currently have, but I think it uses commit titles, right? I'm wondering whether we could customize cliff.toml to use PR titles instead?
Also, is it possible to specify the range between the last tag and the current commit?

I also like the idea of having a "New Contributors" section!