gogs/.github/ISSUE_TEMPLATE/dev_release_minor_version.md

---

name: "Dev: Release a minor version" about: ONLY USED BY MAINTAINERS. title: "Release [VERSION]"

labels: 📸 release

_This is generated from the minor release template._

Before release

On the main branch:

• Close stale issues with the label status: needs feedback.
• Sync locales from Crowdin.
• Update CHANGELOG to include entries for the current minor release.
• Cut a new release branch release/<MAJOR>.<MINOR>, e.g. release/0.12.

During release

On the release branch:

• Update the hard-coded version to the current release, e.g. 0.12.0+dev -> 0.12.0.
• Wait for GitHub Actions to complete and no failed jobs.
• Publish new RC releases (e.g. v0.12.0-rc.1, v0.12.0-rc.2) to ensure Docker workflow succeeds. Make sure the tag is created on the release branch.
  • Pull down the Docker image and run through application setup to make sure nothing blows up.
• Publish a new GitHub release with entries from CHANGELOG for the current minor release. Make sure the tag is created on the release branch.
• Wait for a new image tag for the current release to be created automatically on both Docker Hub and GitHub Container registry.
• Push a new Docker image tag as <MAJOR>.<MINOR> to both Docker Hub and GitHub Container registry, e.g.:
• Compile and pack binaries (all prefixed with gogs_<MAJOR>.<MINOR>.<PATCH>_, e.g. gogs_0.12.0_):
  • macOS: darwin_amd64.zip, darwin_arm64.zip
  • Linux: linux_386.tar.gz, linux_386.zip, linux_amd64.tar.gz, linux_amd64.zip
  • ARM: linux_armv7.tar.gz, linux_armv7.zip, linux_armv8.tar.gz, linux_armv8.zip
  • Windows: windows_amd64.zip, windows_amd64_mws.zip
• Generate SHA256 checksum for all binaries to the file checksum_sha256.txt.
• Upload all binaries and checksum_sha256.txt to:
  • GitHub release
  • https://dl.gogs.io
• Update content of Install from binary.

After release

On the main branch:

• Publish GitHub security advisories for security patches included in the release.
• Update the repository mirror on Gitee.
• Create a new release announcement in Discussions.
• Send a tweet on the official Twitter account for the minor release.
• Send out release announcement emails via Mailchimp.
• Publish a new release article on OSChina.
• Close the minor milestone.
• Bump the hard-coded version to the new develop version, e.g. 0.12.0+dev -> 0.13.0+dev.
• Run task legacy to identify deprecated code that is aimed to be removed in current develop version.