premake/scripts/RELEASE.md

# PREMAKE RELEASE CHECKLIST

## PREP

* Create a new release branch `release/v5.0-beta1`

* Update `CHANGES.txt`
	* Set version at top of file
	* `premake5 --file=scripts/changes.lua --since=<last_release_rev> changes`
	* Review and clean up as needed

* Update `README.md`
	* "Commits since last release" badge (once out of prerelease replace `v5.0.0-alphaXX` with `latest`)

* Update version in `src/host/premake.h`

* Update version in `website/src/pages/download.js`

* Commit changes and push release branch; wait for CI to pass

* Prep release announcement from change log

## RELEASE

* Run `premake5 package <release branch name> source` (from Posix ideally)

* On each platform, run `premake5 package <release branch name> binary`

* Submit Windows binary to [Microsoft malware analysis](https://www.microsoft.com/en-us/wdsi/filesubmission/) _(Can no longer do this unless it has already been flagged as malware; needs the failing signature in order to submit.)_

* Push any remaining changes; tag release branch

* Create new release on GitHub from `CHANGES.txt`; upload files

* Post announcement to `@premakeapp`

## CYCLE

* Update version in `src/host/premake.h` (e.x `"5.0.0-dev"`)

* Commit

* Merge release branch to master

* Delete release branch
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00			`# PREMAKE RELEASE CHECKLIST`

			`## PREP`

Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Create a new release branch `release/v5.0-beta1`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Update `CHANGES.txt`
			`* Set version at top of file`
			* `premake5 --file=scripts/changes.lua --since=<last_release_rev> changes`
			`* Review and clean up as needed`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Update `README.md`
			* "Commits since last release" badge (once out of prerelease replace `v5.0.0-alphaXX` with `latest`)
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Update version in `src/host/premake.h`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Update version in `website/src/pages/download.js`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Commit changes and push release branch; wait for CI to pass`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Prep release announcement from change log`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
			`## RELEASE`

Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Run `premake5 package <release branch name> source` (from Posix ideally)
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* On each platform, run `premake5 package <release branch name> binary`
Add Windows malware analysis step to release checklist 2020-05-21 10:34:42 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Submit Windows binary to [Microsoft malware analysis](https://www.microsoft.com/en-us/wdsi/filesubmission/) _(Can no longer do this unless it has already been flagged as malware; needs the failing signature in order to submit.)_`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Push any remaining changes; tag release branch`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Create new release on GitHub from `CHANGES.txt`; upload files
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Post announcement to `@premakeapp`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
			`## CYCLE`

Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			* Update version in `src/host/premake.h` (e.x `"5.0.0-dev"`)
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Commit`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Merge release branch to master`
Fix up and improve the release docs and script 2020-04-21 21:01:55 +00:00
Prepare 5.0-beta1 release 2021-10-21 20:14:35 +00:00			`* Delete release branch`