Publish a release

Publication procedure

  • Update merge request template to point to a new changelog wiki page
  • Update CHANGELOG.md to point to new GitLab release
  • Create new web release page with generated artifact names (frontmatter only!)
  • Add a link to the (upcoming) Doxygen documentation for this tag in Documentation/mainpage.dox.in (with v-prefix)
  • Update [docs-release]-link in README.md to the new tag (with v-prefix)
  • Add a redirect in scripts/doc/_redirects
  • Update CITATION.cff (Zenodo DOI will be added later)
  • Create a tag and push
  • A new release is automatically created on GitLab
    • Fill in the release notes from the Wiki
    • Convert MR ids to URLs: replace !([0-9][0-9][0-9][0-9]) with [!$1](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/$1) and #([0-9][0-9][0-9][0-9]) with [#$1](https://gitlab.opengeosys.org/ogs/ogs/-/issues/$1)
  • Copy release binaries and container images from CI job to Azure OGS storage to a subdirectory containing the tag name at https://ogsstorage.blob.core.windows.net/binaries/ogs6
  • Create a release on GitHub mirror (ufz/ogs)
  • Check if a Zenodo release is automatically issued
  • Issue a scan on Software Heritage Archive
  • Update CITATION.cff and web/content/publications/_index.md with new Zenodo DOI
  • Update CITATION.cff author list (git shortlog -sne 6.4.3...6.4.2) and corresponding bibtex-entry in publications web page
  • Create bugfix branch
    • Create new netlify site (in an empty directory)
      • netlify init
      • # [ENTER]
      • # ogs-doxygen-v[TAG (- separated instead of .)]
    • Create branch from master with name v[TAG] and push
  • Create a discourse announcement post
    • DOI badge
    • Software heritage badge
    • Link to release page on opengeosys.org
    • Link to GitLab release
    • Link to Zenodo release
    • Link to archive on Software Heritage
  • Set milestone on expired issues and merge requests

This article was written by Lars Bilke. If you are missing something or you find an error please let us know.
Generated with Hugo 0.101.0 in CI job 262272 | Last revision: October 24, 2022
Commit: [web] Update docs on notebook testing and web conversion. 1cb932f  | Edit this page on