Skip to content

Commit 090b1cf

Browse files
authored
[ci skip] Update PHP Release Process (#18342)
1 parent 9306c95 commit 090b1cf

File tree

1 file changed

+20
-35
lines changed

1 file changed

+20
-35
lines changed

docs/release-process.md

+20-35
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ releases.
7474
> When you are unsure about anything, ask a previous RM before proceeding.
7575
> Ideally, make sure a previous RM is available to answer questions during
7676
> the first few releases of your version. For the steps related to the
77-
> `web-php`, `web-qa`, and `web-php-distributions` repositories, try to have
77+
> `web-php` and `web-php-distributions` repositories, try to have
7878
> someone from the webmaster team on hand.
7979
8080
5. Verify the tags to be extra sure everything was tagged properly.
@@ -360,11 +360,10 @@ slightly different steps. We'll call attention where the steps differ.
360360
361361
## Announcing a non-stable release (alpha/beta/RC)
362362
363-
1. Switch to your local clone of the `web-qa` repository and update the
363+
1. Switch to your local clone of the `web-php` repository and update the
364364
information in the `$QA_RELEASES` array in `include/release-qa.php`.
365365
366366
Follow the documentation in the file for editing the QA release information.
367-
See also [Announce 8.1.0RC3][] and [8.1.6RC1][] for examples.
368367
369368
Add, commit, and push your changes, when finished.
370369
@@ -717,39 +716,28 @@ slightly different steps. We'll call attention where the steps differ.
717716
```shell
718717
./bin/news2html 'https://github.com/php/php-src/raw/php-X.Y.Z/NEWS' 'X.Y.Z' 'ChangeLog-X.php'
719718
```
720-
721-
9. Review all the changes in `web-php`, commit, and push them.
722-
723-
```shell
724-
git add -p
725-
git add archive/entries/*.xml releases/*.php
726-
git commit --gpg-sign=YOURKEYID -m "Announce PHP X.Y.Z"
727-
git push upstream master
728-
```
729-
730-
See [Announce PHP 8.1.6][] for an example commit.
731-
732-
10. Switch to your local clone of the `web-qa` repository and update the
733-
information in the `$QA_RELEASES` array in `include/release-qa.php`.
719+
8. Update the information in the `$QA_RELEASES` array in `include/release-qa.php`.
734720
735721
The array probably contains information about the RC released two weeks ago
736722
in preparation for the current release. Since the current release is now GA,
737723
it's time to remove the RC build from the QA website.
738724
739725
It is sufficient to set the `number` property for the release to `0` to
740726
stop displaying the RC build on the QA website. You may also remove the
741-
sha256 hashes for the RC tarballs, but it's not necessary. For an example,
742-
see [PHP 8.1.6 released][].
727+
sha256 hashes for the RC tarballs, but it's not necessary.
743728
744-
Add, commit, and push your changes, when finished.
729+
9. Review all the changes in `web-php`, commit, and push them.
745730
746731
```shell
747732
git add -p
748-
git commit --gpg-sign=YOURKEYID -m "PHP X.Y.Z released"
733+
git add archive/entries/*.xml releases/*.php
734+
git commit --gpg-sign=YOURKEYID -m "Announce PHP X.Y.Z"
749735
git push upstream master
750736
```
751737
752-
11. 🚨 **Before sending announcement emails, check to make sure the websites have
738+
See [Announce PHP 8.1.6][] for an example commit.
739+
740+
10. 🚨 **Before sending announcement emails, check to make sure the websites have
753741
synced.**
754742
755743
* Make sure the tarballs are available from, e.g.,
@@ -761,8 +749,8 @@ slightly different steps. We'll call attention where the steps differ.
761749
e.g., https://www.php.net/ChangeLog-8.php
762750
* Is there a release page for the new version?
763751
e.g., `https://www.php.net/releases/X_Y_Z.php`
764-
* Does the RC for this version still appear on the QA home page?
765-
https://qa.php.net
752+
* Does the RC for this version still appear on the Release Candidate Builds page?
753+
https://www.php.net/release-candidates.php
766754
767755
Keep in mind it may take up to an hour for the websites to sync.
768756
@@ -987,21 +975,22 @@ volunteers to begin the selection process for the next release managers.
987975
988976
## New release manager checklist
989977
990-
1. Request membership to the
978+
1. Fill out [the form](https://www.php.net/git-php.php)
979+
to get a PHP account (if you don't already have one).
980+
981+
2. Request membership to the
991982
[release managers group](https://github.com/orgs/php/teams/release-managers) on GitHub.
992983
993-
2. Subscribe to the php-announce@lists.php.net mailing list by emailing
984+
3. Subscribe to the php-announce@lists.php.net mailing list by emailing
994985
php-announce+subscribe@lists.php.net
995986
996-
3. Email systems@php.net to get setup for access to downloads.php.net, to be
987+
4. Email systems@php.net to get setup for access to downloads.php.net, to be
997988
added to the release-managers@php.net distribution list, and to be added to
998989
the moderators for php-announce@lists.php.net so you are able to moderate
999990
your release announcements.
1000991
1001992
Provide the following information in a single email:
1002993
1003-
- Preferred Unix username (will also become part of location to download RCs,
1004-
such as `https://downloads.php.net/~derick/`).
1005994
- An SSH public key, preferably a new unique one for PHP systems and
1006995
projects.
1007996
- Read [Machine Access](https://wiki.php.net/systems#machine_access) to set
@@ -1022,7 +1011,7 @@ volunteers to begin the selection process for the next release managers.
10221011
> "[Send emails from a different address or alias][]."
10231012
10241013
1025-
4. Create a [GPG key][] for your @php.net address.
1014+
5. Create a [GPG key][] for your @php.net address.
10261015
10271016
> 💡 **Tip** \
10281017
> If you're new to GPG, follow GitHub's instructions for
@@ -1087,11 +1076,10 @@ volunteers to begin the selection process for the next release managers.
10871076
git push
10881077
```
10891078
1090-
5. Make sure you have the following repositories cloned locally:
1079+
6. Make sure you have the following repositories cloned locally:
10911080
10921081
* https://github.com/php/php-src
10931082
* https://github.com/php/web-php
1094-
* https://github.com/php/web-qa
10951083
* https://github.com/php/web-php-distributions
10961084
10971085
@@ -1106,13 +1094,10 @@ volunteers to begin the selection process for the next release managers.
11061094
[Update NEWS for PHP 8.2.0RC6]: https://github.com/php/php-src/commit/4ccc414961a70200d638ca281a35f893226d74e2
11071095
[PHP 8.3 is now for PHP 8.3.21-dev]: https://github.com/php/php-src/commit/b57f425cfe20a11003253427424cc0517483550b
11081096
[GitHub command line tool]: https://cli.github.com
1109-
[Announce 8.1.0RC3]: https://github.com/php/web-qa/commit/f264b711fd3827803b79bbb342959eae57ea502b
1110-
[8.1.6RC1]: https://github.com/php/web-qa/commit/e6d61ad7a9d8be0b1cd159af29f3b9cbdde33384
11111097
[merged upwards as usual]: https://wiki.php.net/vcs/gitworkflow
11121098
[Update versions for PHP 8.1.7]: https://github.com/php/php-src/commit/d35e577a1bd0b35b9386cea97cddc73fd98eed6d
11131099
[Update NEWS for PHP 8.1.7]: https://github.com/php/php-src/commit/b241f07f52ca9f87bf52be81817f475e6e727439
11141100
[Announce PHP 8.1.6]: https://github.com/php/web-php/commit/9f796a96c65f07e45845ec248933bfb0010b94a9
1115-
[PHP 8.1.6 released]: https://github.com/php/web-qa/commit/bff725f8373cf6fd9d97ba62a8517b19721a4c2e
11161101
[feature freeze]: https://en.wikipedia.org/wiki/Freeze_(software_engineering)
11171102
[Prepare for PHP 8.2]: https://github.com/php/php-src/commit/1c33ddb5e5598c5385c4c965992c6e031fd00dd6
11181103
[Prepare for PHP 8.2 (bis)]: https://github.com/php/php-src/commit/a93e12f8a6dfc23e334339317c97aa35356db821

0 commit comments

Comments
 (0)