@@ -162,7 +162,10 @@ slightly different steps. We'll call attention where the steps differ.
162
162
4. Using your local-only release branch, bump the version numbers in
163
163
`main/php_version.h`, `Zend/zend.h`, `configure.ac`, and possibly
164
164
`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
+
166
169
For examples, see [Update versions for PHP 8.1.0beta3][] (for a pre-GA
167
170
example) or [Update versions for PHP 8.1.6RC1][] along with
168
171
[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.
250
253
git commit --gpg-sign=YOURKEYID -m "[ci skip] Update NEWS for PHP X.Y.Z alpha2"
251
254
```
252
255
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
+
253
259
🔷 **For post-GA releases only,** switch back to the *version branch* for
254
260
your release (e.g., `PHP-8.2`) and bump the version numbers in
255
261
`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.
365
371
366
372
Follow the documentation in the file for editing the QA release information.
367
373
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
+
368
378
Add, commit, and push your changes, when finished.
369
379
370
380
` ` ` shell
@@ -408,6 +418,15 @@ slightly different steps. We'll call attention where the steps differ.
408
418
text slightly to indicate progression through the pre-release cycle. For
409
419
example, here are all the news posts for the pre-GA releases of PHP 8.1.0:
410
420
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
+
411
430
* [Announce 8.1.0alpha1](https://github.com/php/web-php/commit/57b9675c8d8550493289fa1fba77427c93cdd472)
412
431
* [Announce 8.1.0alpha2](https://github.com/php/web-php/commit/cec044fc0763f5cfa77d0e79479f8b6279023570)
413
432
* [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.
431
450
> When a version is in its post-GA phase, we do not post news entries for
432
451
> non-stable releases.
433
452
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
435
454
sending announcements. This could take up to an hour.
436
455
437
456
4. Send * separate* announcement emails to:
@@ -720,10 +739,10 @@ slightly different steps. We'll call attention where the steps differ.
720
739
721
740
The array probably contains information about the RC released two weeks ago
722
741
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 .
724
743
725
744
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
727
746
sha256 hashes for the RC tarballs, but it' s not necessary.
728
747
729
748
9. Review all the changes in ` web-php` , commit, and push them.
0 commit comments