WIP: Add release-notes generator script and update release docs#1785
WIP: Add release-notes generator script and update release docs#1785wallrj-cyberark wants to merge 6 commits intocert-manager:masterfrom
Conversation
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
✅ Deploy Preview for cert-manager ready!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
51de3c4 to
a3349fd
Compare
- Add scripts/release-notes Go tool (main, tests, go.mod, go.sum) and README - Add make target generate-release-notes using CERT_MANAGER_VERSION from content/docs/variables.json to run the tool and write site release notes - Tidy make/02_mod.mk: add generate-release-notes target and fix PATH newline Signed-off-by: Richard Wall <richard.wall@cyberark.com>
- Add machine-readable {/* BEGIN/END contributors */} markers to the
- release notes to enable automated contributor extraction
- Add {/* BEGIN/END changelog */} markers around v1.18.2, v1.18.1 and
- v1.18.0 sections so the release generator can parse changelogs
Signed-off-by: Richard Wall <richard.wall@cyberark.com>
- Remove dependency on the k8s release-notes CLI and related env vars - Re-number and streamline setup: cmrel, gcloud, gsutil, cosign - Consolidate release notes generation and add guidance to run make generate-release-notes - Clarify GitHub release publishing, website PRs, and bump versions workflow Signed-off-by: Richard Wall <richard.wall@cyberark.com>
Signed-off-by: Richard Wall <richard.wall@cyberark.com>
a3349fd to
effb7f3
Compare
…relative - Add .spelling file listing release tags v1.18.0 v1.18.1 v1.18.2 - Enable mdspell --target-relative in package.json check:spelling - Wrap release-notes filename in docs with inline code formatting Signed-off-by: Richard Wall <richard.wall@cyberark.com>
Signed-off-by: Richard Wall <richard.wall@cyberark.com>
|
PR needs rebase. DetailsInstructions 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-sigs/prow repository. |
| @@ -0,0 +1,101 @@ | |||
| # Release Notes Generator | |||
There was a problem hiding this comment.
I've tested this script, but wasn't able to run it because I hadn't create the tag yet. The release process says that I should prepare the release notes before releasing. Here is what I'm getting:
$ cd scripts/release-notes
$ go run . --release-notes-dir ../../content/docs/releases/release-notes --release-version v1.20.1
INFO[0000] Cloning/updating repository cert-manager/cert-manager
INFO[0015] Using found start SHA: 0d2f215fe26ca2674758b5dfd780f04ac1dfde92
invalid configuration: invalid notes options: resolving v1.20.1: reference not found
exit status 1
Creating and updating the release notes has always been one of the most laborious parts of the cert-manager release process for me and this script encodes various manual steps that had previously taken a long time and patience to get right.
The tool captures and automates some the tedious, error-prone steps of producing release notes so we spend less time formatting and more time reviewing content and thanking contributors.