Skip to content

Add release publishing script and update release documentation #2143

@jfrost-mo

Description

What problem does your feature request solve?

The release documentation at https://metoffice.github.io/CSET/contributing/releases.html is out of date (at least on writing the release notes). Furthermore I am the only person who knows the full release process, and it would be good to document this in case I get hit buy a bus or win the lottery.

Describe the solution you'd like

Make a release script for CSET, so you can just do make release. Do as an executable instruction script, pausing whenever a manual step is needed. The script should:

  1. Automate release note generation, dropping the headings for simplicity.
  2. Leave placeholder and get user to write prose description.
  3. Push to GitHub and make PR adding release notes.
  4. Once merged, tag release and push tag to GitHub, and API request to make the release.
  5. Provide instructions (or GitHub API and open issue triggering the auto-update bot) for updating the conda-forge repository.
  6. Finally provide notice that the conda-forge CDN will take a while to update.

The documentation will need to be updated to note that this script should be run.

Describe alternatives you've considered

We could just update the documentation with the manual steps, however there is value in automation to minimise mistakes. Additionally, having the script be executed every time a release is made will ensure it remains up-to-date with the process, rather than risking the documentation getting out-of-date.

Metadata

Metadata

Labels

cleanupNon-functional improvementdocumentationImprovements or additions to documentation

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions