Release Check List
(Redirected from How to make a release)
Jump to navigation
Jump to search
FIXME: How to make a release seems to be a duplicate of this, anything there that is missing here should be copied over
This is a checklist of the steps to do a stable release. Some of this can be automated in the future.
Branching[edit]
- Make sure all release blocker bugs are resolved
- If the required FreeBasic version has increased, verify that it has been bumped in README.txt
- Make sure whatsnew.txt is up to date
- branch wip -> rel/codename
- Put the release codename into codename.txt on the branch, also update the svn revision where the branch happened
- Run docs/update-html.sh after updating codename.txt, so it updates the codename in the .xml. (Note that none of the distrib or release scripts do this automatically.)
- Update any of the README-* files which reference release codename at the top
Release Building[edit]
- On each build environment, run the release scripts in the rel/codename branch in the release folder. (make sure the repo is fully updated)
- Run release-linux-x86.sh on a 32 bit Linux build env
- Run release-linux-x86_64.sh on a 64 bit Linux build env
- Run release-mac.sh on a Mac build env
- Run release-win.bat on a Windows build env
- Run release-android.sh on a Linux Android build env
- Run release-web.sh on Linux with docker installed
Testing[edit]
- Files will be available from https://hamsterrepublic.com/ohrrpgce/archive/
- Ask the denizens of SlimeSalad forums and Discord to test
- Download and test for each platform
- To sanity-check the "Distribute Game" menu, you can ssh into motherhamster.org (HamsterRepublic.com) and run script/ohrstable.sh -p to update the stable links just for the player-only files.
- Note that if this release increments the packaging_version in buildinfo.ini as compared to the previous release, then this test may break the "Distribute Game" feature of previous stable versions, and should only be done briefly, with caution
Finalized Release[edit]
- Some of the above steps may need to be repeated if problems are found in the testing phase
- To finalize the release, ssh into motherhamster.org (HamsterRepublic.com) and run script/ohrstable.sh to update all the links.
- Run the release/release-docs.sh script from the rel/codename branch on a Linux dev env
- Run the release/release-itchio.sh script from any branch on a Linux computer
Wiki Updates[edit]
- Update the links on the Downloads page
- Update the page that describes the release to say it is current.
- Modify previous release page to mention that it's obsolete
- Update Current version to redirect to the new release's page
- Update any other relevant pages in Category:Articles that change at each release
- Remove the {{WIP}} tag for any pages that mention WIP features when appropriate.
- Mention the update on the News page
Buglist Updates[edit]
- Add a "rel:..." label for the new release
- Replace the rel: nightlies label on any open bugs with the new rel label (some of these bugs may actually have been present in the previous release, but that's OK)
- Add a milestone for the next release
- Poke TMC to update Bughunters League Table/Release Leaderboards