Skip to content

Commit 642d729

Browse files
release-process: update some confusing parts (#18934)
Update based on my training with Pierrick * dates should correspond to when releases are released, not tagged * qa.php.net is no longer used * bugs.php.net is no longer used * multiple commits to web-php can be combined
1 parent 607eec8 commit 642d729

File tree

1 file changed

+23
-4
lines changed

1 file changed

+23
-4
lines changed

‎docs/release-process.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,10 @@ slightly different steps. We'll call attention where the steps differ.
162162
4. Using your local-only release branch, bump the version numbers in
163163
`main/php_version.h`, `Zend/zend.h`, `configure.ac`, and possibly
164164
`NEWS`.
165-
165+
166+
The date for NEWS should be the date of the announcement (Thursday),
167+
*not* the date of the tagging (Tuesday).
168+
166169
For examples, see [Update versions for PHP 8.1.0beta3][] (for a pre-GA
167170
example) or [Update versions for PHP 8.1.6RC1][] along with
168171
[Update NEWS for PHP 8.1.6RC1][] (for a post-GA example).
@@ -250,6 +253,9 @@ slightly different steps. We'll call attention where the steps differ.
250253
git commit --gpg-sign=YOURKEYID -m "[ci skip] Update NEWS for PHP X.Y.Z alpha2"
251254
```
252255
256+
The NEWS is updated at the *start* of the cycle for the next tag, e.g.
257+
[Update NEWS for PHP 8.2.0 alpha2][] was sent as part of tagging 8.2.0 alpha **1**.
258+
253259
🔷 **For post-GA releases only,** switch back to the *version branch* for
254260
your release (e.g., `PHP-8.2`) and bump the version numbers in
255261
`main/php_version.h`, `Zend/zend.h`, `configure.ac` and `NEWS`. This prepares
@@ -365,6 +371,10 @@ slightly different steps. We'll call attention where the steps differ.
365371
366372
Follow the documentation in the file for editing the QA release information.
367373
374+
> 🚨 **Attention** \
375+
> **For pre-GA releases only,** don't commit yet, because you need to add an
376+
> announcement with the release. After updating `$QA_RELEASES`, skip to step 2 below.
377+
368378
Add, commit, and push your changes, when finished.
369379
370380
```shell
@@ -408,6 +418,15 @@ slightly different steps. We'll call attention where the steps differ.
408418
text slightly to indicate progression through the pre-release cycle. For
409419
example, here are all the news posts for the pre-GA releases of PHP 8.1.0:
410420
421+
> 💬 **Hint** \
422+
> If you are going to base your language on one of these old announcements,
423+
> remember that
424+
> * `qa.php.net` has been replaced with https://www.php.net/release-candidates.php
425+
> * `bugs.php.net` has been replaced with GitHub issues, use
426+
> `https://github.com/php/php-src/issues/new?template=bug_report.yml`
427+
> to link directly to the form for creating a new bug report.
428+
> * Since 8.4 there have only been 4 release candidates for PHP X.Y.0, rather than 6.
429+
411430
* [Announce 8.1.0alpha1](https://github.com/php/web-php/commit/57b9675c8d8550493289fa1fba77427c93cdd472)
412431
* [Announce 8.1.0alpha2](https://github.com/php/web-php/commit/cec044fc0763f5cfa77d0e79479f8b6279023570)
413432
* [Announce 8.1.0alpha3](https://github.com/php/web-php/commit/5c480765f444a3fddfd575e01fe0be3fcfdde05b)
@@ -431,7 +450,7 @@ slightly different steps. We'll call attention where the steps differ.
431450
> When a version is in its post-GA phase, we do not post news entries for
432451
> non-stable releases.
433452
434-
3. Wait for the web and qa sites to update with the new information before
453+
3. Wait for the php site to update with the new information before
435454
sending announcements. This could take up to an hour.
436455
437456
4. Send *separate* announcement emails to:
@@ -720,10 +739,10 @@ slightly different steps. We'll call attention where the steps differ.
720739
721740
The array probably contains information about the RC released two weeks ago
722741
in preparation for the current release. Since the current release is now GA,
723-
it's time to remove the RC build from the QA website.
742+
it's time to remove the RC build from the release candidates page.
724743
725744
It is sufficient to set the `number` property for the release to `0` to
726-
stop displaying the RC build on the QA website. You may also remove the
745+
stop displaying the RC build on the release candidates page. You may also remove the
727746
sha256 hashes for the RC tarballs, but it's not necessary.
728747
729748
9. Review all the changes in `web-php`, commit, and push them.

0 commit comments

Comments
 (0)