diff --git a/docs/release-process.md b/docs/release-process.md index 0ce2dfddb756b..1c6794bdfb27c 100644 --- a/docs/release-process.md +++ b/docs/release-process.md @@ -771,53 +771,13 @@ slightly different steps. We'll call attention where the steps differ. ([@official_php](https://twitter.com/official_php)) -## Re-releasing the same version or a patch-level (i.e., `-plN`) +## Fixing the released version -While unlikely, there may be times we need to re-release the same version. This +While unlikely, there may be times we need to fix the released version. This might happen if the tarballs have a corrupted file, for example. -Should this occur *before* announcing the release, you may choose to delete the -tag and go through the full packaging process again, as described above. - -> 💬 **Hint** \ -> This is one of the reasons we package releases two days before announcing -> them. - -If this happens *after* announcing the release, you may choose to tag, package, -and release a patch-level (i.e., *pl*) release. If it is not critical and/or -affects a very limited subset of users, then you may choose to wait until the -next release. - -If you choose to create a patch-level release, follow these steps: - -1. Commit the new binaries to `web-php-distributions` - -2. Update $data['X.Y'] in `web-php:/include/version.inc` - (X.Y=major.minor release, e.g. '8.0'): - - * `version` to the full version number (e.g. '8.0.1-pl1') - * `date` to the release date in `j M Y` format (e.g. '9 Jan 2021') - * `tags` array should include `security` if this is a security release - * `sha256` array and sub-elements for all SHA256 sums - -3. Add a short notice to `web-php` stating that there is a new release, and - highlight the major important things (security fixes) and when it is - important to upgrade. - - * Call `php bin/createReleaseEntry -v [ --security ]` in your - local web-php checkout. - -4. Commit all the changes (`include/version.inc`, `archive/archive.xml`, - `archive/entries/YYYY-MM-DD-N.xml`). - -5. Wait an hour or two, then send a mail to php-announce@lists.php.net, - php-general@lists.php.net and internals@lists.php.net with a text similar to - the news entry. - - Please make sure that the mail to php-announce@ is its own completely - separate email. This is to make sure that replies to the announcement on - php-general@ or internals@ will not accidentally hit the php-announce@ - mailinglist. +You should choose to tag, package, and release a **new version** +through the full packaging process again, as described above. ## Feature freeze