php runtime generation 2 docs copy updates (#9774)

* php runtime generation 2 docs copy updates

* Update anchor in crosslinks

---------

Co-authored-by: Rachel Whitton <rachel@pantheon.io>

Author: scottbuscemi

source/content/php-runtime-generation-2.md

@@ -15,7 +15,7 @@ integration: [--]
 
 The new generation of Pantheon's serverless PHP runtime represents our commitment to providing a modern, secure, and efficient PHP runtime for your websites.
 
-Depending on your website's features, this new PHP runtime may have major effects on the operation of your site. We invite you to test your site for compatibility and performance to ensure a seamless upgrade. The previous generation will be removed in early 2026.
+Depending on your website's features, this new PHP runtime may have major effects on the operation of your site. The previous generation will be removed in early 2026.
 
 ## What's included?
 
@@ -45,11 +45,11 @@ Since any `pantheon.yml` changes are part of your site repository and promoted i
 |-----------|------------------|--------------|
 | **Beta** | May - September 16, 2025 | Environments can be opted-in. All other environments will remain on the previous generation. |
 | **New Sites** | September 17, 2025 | New sites created on the platform will use PHP Runtime Generation 2. |
-| **Gen 2 Rollout** | September 24 - November 23, 2025 | A 60-day rollout will gradually upgrade sites to PHP Runtime Generation 2. [Sites may be opted-out](#q-how-do-i-opt-out-of-the-upcoming-platform-rollout). |
+| **Gen 2 Rollout** | September 24 - November 23, 2025 | A 60-day rollout will gradually upgrade sites to PHP Runtime Generation 2. [Sites may be opted-out](#q-how-do-i-opt-out-of-php-runtime-generation-2). |
 | **Gen 1 Removal** | Early 2026 | PHP Runtime Generation 1 will no longer be available. All remaining sites will be auto-upgraded. |
 
 ### Current Phase Details 
-Currently, we are in the **Gen 2 Rollout** phase. The upgrade rollout will take place over the next 60 days. The table below shows which upgrades are being processed. [Sites may be opted-out](#q-how-do-i-opt-out-of-the-upcoming-platform-rollout). We will revise this section of documentation as we begin each phase along with any updates to the timeline. 
+Currently, we are in the **Gen 2 Rollout** phase. The upgrade rollout will take place over the next 60 days. The table below shows which upgrades are being processed. [Sites may be opted-out](#q-how-do-i-opt-out-of-php-runtime-generation-2). We will revise this section of documentation as we begin each phase along with any updates to the timeline. 
 
 <Alert type="info" title="Deploying code will upgrade test/live environments">
 
@@ -79,7 +79,7 @@ Once the Dev environment for a site has been upgraded to Generation 2, deploying
 | **Apache Tika** | 1.18, 1.21 | 1.18, 1.21, [3.2](/external-libraries#apache-tika) |
 | **PhantomJS** | 1.7.0, 2.1.1 available | Not available |
 
-<sup>1</sup> Support for this OS Package will be added after the platform-wide rollout begins. If you depend on this OS Package, we recommend you <a href="#q-how-do-i-opt-out-of-the-upcoming-platform-rollout">opt out of Runtime Generation 2</a> for now. <br /><br />
+<sup>1</sup> Support for this OS Package will be added after the platform-wide rollout begins. If you depend on this OS Package, we recommend you <a href="#q-how-do-i-opt-out-of-php-runtime-generation-2">opt out of Runtime Generation 2</a> for now. <br /><br />
 
 ### PHP Extensions
 
@@ -98,7 +98,7 @@ Once the Dev environment for a site has been upgraded to Generation 2, deploying
 | **redis** | 5.3.7<br/>Compression types: zstd | 6.2.0<br/>Compression types: zstd, lzf, lz4 |
 | **sqlite3** | 3.26.0 | 3.40.1 |
 
-<sup>1</sup> Support for these PHP extensions may be added after the platform-wide rollout begins. If you depend on this PHP Extension, we recommend you <a href="#q-how-do-i-opt-out-of-the-upcoming-platform-rollout">opt out of PHP Runtime Generation 2</a> for now. <br /><br />
+<sup>1</sup> Support for these PHP extensions may be added after the platform-wide rollout begins. If you depend on this PHP Extension, we recommend you <a href="#q-how-do-i-opt-out-of-php-runtime-generation-2">opt out of PHP Runtime Generation 2</a> for now. <br /><br />
 
 Does your application require an OS package or PHP extension that is no longer available? Please reach out to us to discuss compatibility by contacting your Customer Success Manager or creating a support ticket.
 
@@ -116,7 +116,7 @@ Does your application require an OS package or PHP extension that is no longer a
 
 ## Reporting Issues
 
-If you encounter any issues while testing your site with PHP Runtime Generation 2:
+If you encounter any issues with PHP Runtime Generation 2:
 
 1. Check the Known Issues section above
 2. Verify the issue is related to the new PHP runtime by reverting back to `1` in your `pantheon.yml` file.
@@ -136,7 +136,7 @@ The PHP runtime is set at the environment-level. You can find out which generati
 
 Potentially. Depending on your integrations with our PHP extensions and operating system libraries, you may need to update your website to be compatible with new PHP runtime.
 
-### Q: How do I opt out of the automatic rollout?
+### Q: How do I opt out of PHP Runtime Generation 2?
 
 You may opt-out of the platform rollout by setting the following in your `pantheon.yml`:
 
@@ -156,7 +156,7 @@ php_runtime_generation: 1
 
 ### Q: After upgrading to PHP Runtime Generation 2, I removed php_runtime_generation from my pantheon.yml but the environment did not go back to Generation 1. How do I downgrade?
 
-To revert back to the first generation PHP runtime, set the following in your `pantheon.yml`:
+To revert back to the first generation PHP runtime, you must set the following in your `pantheon.yml`:
 
 ```yaml:title=pantheon.yml
 php_runtime_generation: 1

source/releasenotes/2025-08-08-wkhtmltopdf-dompdf-with-php-runtime-gen-2.md

@@ -12,4 +12,4 @@ However, wkhtmltopdf has not been updated by its maintainers for 5 years and is
 
 Sites that are using wkhtmltopdf should switch to [dompdf](https://github.com/dompdf/dompdf/). Dompdf is a PHP-based rendering engine that can be placed inside a site's codebase. Please refer to the [External Libraries documentation](/external-libraries#wkhtmltopdf-deprecated) for information on how to make this switch.
 
-PHP Runtime Generation 2 will begin rolling out September 24. If you need more time to switch to dompdf, we recommend [opting out for now](/php-runtime-generation-2#q-how-do-i-opt-out-of-the-upcoming-platform-rollout).
+PHP Runtime Generation 2 will begin rolling out September 24. If you need more time to switch to dompdf, we recommend [opting out for now](/php-runtime-generation-2#q-how-do-i-opt-out-of-php-runtime-generation-2).

source/releasenotes/2025-08-11-php-runtime-generation-2-rollout.md

@@ -21,11 +21,11 @@ categories: [infrastructure, action-required]
 
 ## What's Currently Unavailable with Generation 2?
 
-Some PHP extensions and OS packages have not been ported over to Generation 2 yet, and may never be ported. Review the [OS Packages and PHP Extensions documentation](/php-runtime-generation-2#os-packages) to review these changes. If you depend on these, we recommend you [opt out of Runtime Generation 2](/php-runtime-generation-2#q-how-do-i-opt-out-of-the-upcoming-platform-rollout) for now, and contact your Customer Success Manager or create a support ticket to discuss your site needs.
+Some PHP extensions and OS packages have not been ported over to Generation 2 yet, and may never be ported. Review the [OS Packages and PHP Extensions documentation](/php-runtime-generation-2#os-packages) to review these changes. If you depend on these, we recommend you [opt out of Runtime Generation 2](/php-runtime-generation-2#q-how-do-i-opt-out-of-php-runtime-generation-2) for now, and contact your Customer Success Manager or create a support ticket to discuss your site needs.
 
 ## Action Recommended
 
-We recommend all customers test your sites ahead of the rollout to identify any compatibility issues. Sites relying on unavailable extensions or packages should [opt out](/php-runtime-generation-2#q-how-do-i-opt-out-of-the-upcoming-platform-rollout) before September 17. We will attempt to auto-detect incompatible sites and delay their upgrade when possible.
+We recommend all customers test your sites ahead of the rollout to identify any compatibility issues. Sites relying on unavailable extensions or packages should [opt out](/php-runtime-generation-2#q-how-do-i-opt-out-of-php-runtime-generation-2) before September 17. We will attempt to auto-detect incompatible sites and delay their upgrade when possible.
 
 ## Rollout Timeline
 
@@ -36,6 +36,6 @@ It is safe to use the PHP Runtime Generation 2 beta on a Live environment once y
 | Phase | Date | Details |
 |-----------|------------------|--------------|
 | **Beta** | May - September 23, 2025 | Environments can be opted-in. All other environments will remain on the previous generation. |
-| **Gen 2 Rollout** | Starting September 24 | A 40-day rollout will gradually upgrade sites to PHP Runtime Generation 2. [Sites may be opted-out](/php-runtime-generation-2#q-how-do-i-opt-out-of-the-upcoming-platform-rollout). |
+| **Gen 2 Rollout** | Starting September 24 | A 40-day rollout will gradually upgrade sites to PHP Runtime Generation 2. [Sites may be opted-out](/php-runtime-generation-2#q-how-do-i-opt-out-of-php-runtime-generation-2). |
 | **Gen 1 Removal** | Early 2026 | PHP Runtime Generation 1 will no longer be available. All remaining sites will be auto-upgraded. |
 

source/releasenotes/2025-09-24-php-runtime-gen2-rollout-begins.md

@@ -6,7 +6,7 @@ categories: [infrastructure]
 
 [PHP Runtime Generation 2](/php-runtime-generation-2) includes updated extensions, PHP 8.4 availability, and enhanced security features. This new PHP runtime is currently rolling out to existing sites on the platform.
 
-We continue to encourage customers to [upgrade to Generation 2 proactively](/php-runtime-generation-2#how-to-opt-in), or [manually opt-out](/php-runtime-generation-2#q-how-do-i-opt-out-of-the-upcoming-platform-rollout) if you need more time.
+We continue to encourage customers to [upgrade to Generation 2 proactively](/php-runtime-generation-2#how-to-opt-in), or [manually opt-out](/php-runtime-generation-2#q-how-do-i-opt-out-of-php-runtime-generation-2) if you need more time.
 
 ## Rollout Timeline