This document provides a step-by-step list to remind Orca maintainers how to make a release. The general instructions for a release are here: https://handbook.gnome.org/maintainers/making-a-release.html Here's a summary for Orca: PREPARE SOURCES FOR THE RELEASE: ------------------------------- Make sure you are up to date: git pull git status Run the `generate_gsettings_documentation.py` and `generate_dbus_documentation.py` tools. Note that the latter requires that Orca is running. Update ./NEWS with changes from the last tagged release. You can use commands like the following: Detailed commits since the 48.beta tag: git log 48.beta.. Short list of translation changes with author names and files: git log 48.beta.. --grep translation --pretty=format:"%s - %an" --name-only Quick-and-dirty formatted list of translation changes: git log 48.beta.. --grep translation --pretty=format:"%s,%an" --name-only | awk -F/ '/\.po/ {gsub("\\.po", "", $NF); printf(",%s",$NF); next;} {gsub("(Updated* |Add(ed)* | translation| help)", "", $0); printf("\n%s",$0);}' | awk -F, '!seen[$0]++ {if (NF == 3) printf(" %-15s %-25s %s\n", $3, $1, $2);}' | sort Short list of non-translation commits: git log 48.beta.. --grep translation --invert-grep --pretty=format:" * %s%n" NOTE: You should also make sure the external dependencies listed in meson.build and README.md are accurate. COMMIT RELEASE CHANGES AND TAG THE RELEASE, TRIGGERING A RELEASE BUILD: ----------------------------------------------------------------------- git commit -a git push git tag -a -s 48.rc git push origin 48.rc BUMP THE VERSION: ----------------- Modify this line in ./meson.build: version: '48.rc' The major version (48) increments by 1 each new GNOME release cycle. The minor version proceeds as follows: alpha, beta, rc, 0, 1, 2, 3, etc. Modify ./README.md to make sure it has the right Orca version. If this is a .0 release, modify this line in .gitlab/issue_templates/Default.md: *Note that versions prior to version XX.x are unsupported for non-critical issues.* setting "XX" to the major release preceding this one. git commit -a git push