Skip to content

Commit a9f9091

Browse files
committed
Remove language for recreating tags (which is dangerous), and using patch levels (which isn't standard practise).
1 parent 0d15bca commit a9f9091

File tree

1 file changed

+6
-40
lines changed

1 file changed

+6
-40
lines changed

docs/release-process.md

Lines changed: 6 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -829,53 +829,19 @@ slightly different steps. We'll call attention where the steps differ.
829829
for posting the release announcement to Mastodon. Posts need to be
830830
approved.
831831
832-
## Re-releasing the same version or a patch-level (i.e., `-plN`)
832+
## Re-releasing the same version
833833
834834
While unlikely, there may be times we need to re-release the same version. This
835-
might happen if the tarballs have a corrupted file, for example.
836-
837-
Should this occur *before* announcing the release, you may choose to delete the
838-
tag and go through the full packaging process again, as described above.
835+
might happen if the tarballs have a corrupted file, for example, or when there
836+
is a build error.
839837
840838
> 💬 **Hint** \
841839
> This is one of the reasons we package releases two days before announcing
842840
> them.
843841
844-
If this happens *after* announcing the release, you may choose to tag, package,
845-
and release a patch-level (i.e., *pl*) release. If it is not critical and/or
846-
affects a very limited subset of users, then you may choose to wait until the
847-
next release.
848-
849-
If you choose to create a patch-level release, follow these steps:
850-
851-
1. Commit the new binaries to `web-php-distributions`
852-
853-
2. Update $data['X.Y'] in `web-php:/include/version.inc`
854-
(X.Y=major.minor release, e.g. '8.0'):
855-
856-
* `version` to the full version number (e.g. '8.0.1-pl1')
857-
* `date` to the release date in `j M Y` format (e.g. '9 Jan 2021')
858-
* `tags` array should include `security` if this is a security release
859-
* `sha256` array and sub-elements for all SHA256 sums
860-
861-
3. Add a short notice to `web-php` stating that there is a new release, and
862-
highlight the major important things (security fixes) and when it is
863-
important to upgrade.
864-
865-
* Call `php bin/createReleaseEntry -v <version> [ --security ]` in your
866-
local web-php checkout.
867-
868-
4. Commit all the changes (`include/version.inc`, `archive/archive.xml`,
869-
`archive/entries/YYYY-MM-DD-N.xml`).
870-
871-
5. Wait an hour or two, then send a mail to [email protected],
872-
[email protected] and [email protected] with a text similar to
873-
the news entry.
874-
875-
Please make sure that the mail to php-announce@ is its own completely
876-
separate email. This is to make sure that replies to the announcement on
877-
php-general@ or internals@ will not accidentally hit the php-announce@
878-
mailinglist.
842+
You *must not* delete and recreate a pushed tag. Instead, you need to go
843+
through the full packaging process again, as described above, whilst increasing
844+
the version number. This is unfortunate, but published tags must be immutable.
879845
880846
881847
## Soft feature freeze

0 commit comments

Comments
 (0)