Merge pull request #532 from humanmade/backport-upgrade-guide-improve…

…ments Backport upgrade guide improvements
humanmade · Aug 14, 2023 · f8c7d21 · f8c7d21
2 parents 077821c + fbacf9f
commit f8c7d21
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 17 deletions.
diff --git a/other-docs/guides/upgrading/README.md b/other-docs/guides/upgrading/README.md
@@ -35,6 +35,7 @@ Any upgrade will usually require some modification to your project (for example,
 
 ## Upgrade Guides
 
+- [Version 16](./v16.md)
 - [Version 15](./v15.md)
 - [Version 14](./v14.md)
 - [Version 13](./v13.md)

diff --git a/other-docs/guides/upgrading/v16.md b/other-docs/guides/upgrading/v16.md
@@ -4,25 +4,26 @@ order: 16
 
 # Upgrading to v16
 
-_If you are migrating from WordPress to Altis, check out the [migrating guide](../migrating/) first._
+_If you are migrating from WordPress to Altis, check out
+the [migrating guide here](../migrating/) first._
 
 To upgrade to Altis v16, edit your `composer.json` and change the version
 constraint for `altis/altis` and any local
 environment modules to `^16.0.0`.
 
 ```json
 {
-  "require": {
-	"altis/altis": "^16.0.0"
-  },
-  "require-dev": {
-	"altis/local-server": "^16.0.0"
-  },
-  "config": {
-	"platform": {
-	  "php": "8.0"
+	"require": {
+		"altis/altis": "^16.0.0"
+	},
+	"require-dev": {
+		"altis/local-server": "^16.0.0"
+	},
+	"config": {
+		"platform": {
+			"php": "8.0"
+		}
 	}
-  }
 }
 ```
 
@@ -41,16 +42,32 @@ composer server cli -- altis migrate
 
 ### PHP 8.2 ###
 
-Altis v16 fully supports PHP 8.2 in both local and cloud environments. There are a number of [backward incompatible changes](https://www.php.net/manual/en/migration82.incompatible.php) in PHP 8.2 which should be taken into consideration and addressed.
+Altis v16 continues our experimental support for PHP 8.2 in both local and cloud environments. We have improved
+compatability with PHP 8.2 (and 8.1) but there are a number
+of [backward incompatible changes](https://www.php.net/manual/en/migration82.incompatible.php) in PHP 8.2 which you
+should take into consideration.
 
-Refer to our [PHP Version Guide](docs://guides/updating-php/) for up-to-date compatibility, testing and upgrading information.
+Refer to our [PHP Version Guide](docs://guides/updating-php/) for up-to-date compatibility, testing and upgrading
+information.
 
 ## Headline Features
 
-### Altis Core improvements 
+### Afterburner
 
-A number of modules and libraries have been updated to incorporate important bug fixes and improvements.
+Altis v16 comes with Afterburner support which is a drop-in implementation of the WP Object Cache API and WordPress'
+translation API as a PHP Extension backed by Redis.
 
-### Documentation 
+We created our own PHP extension just to optimise WordPress performance. We’ve taken the slowest,
+most-used parts of WordPress, and reimplemented them to squeeze every drop of performance out of your site.
 
-Some of our developer focussed documentation has been clarified and improved, taking on board feedback from our customers and partners. 
+To activate Afterburner on your environment, [create a support ticket](support://new) with the request.
+
+### Altis Core improvements
+
+We made over twenty-five updates to modules and libraries in Altis to bring in important bug fixes and improvements.
+This includes the WordPress CMS, which we updated to version 6.2.2.
+
+### Documentation
+
+Our developer focussed documentation has been improved again. As usual, feedback from our
+customers and partners is always welcome. Please [send us any feedback you have](mailto://[email protected]).