Merge pull request #544 from humanmade/backport-543-to-v17-branch

[Backport v17-branch] Fix errors in v17 upgrade guide

other-docs/guides/upgrading/v17.md

@@ -12,21 +12,21 @@ constraint for `altis/altis` and any local environment modules to `^17.0.0`.
 
 ```json
 {
-	"require": {
-		"altis/altis": "^17.0.0"
-	},
-	"require-dev": {
-		"altis/local-server": "^17.0.0"
-	},
-	"config": {
-		"platform": {
-			"php": "8.1"
-		}
-	}
+    "require": {
+       "altis/altis": "^17.0.0"
+    },
+    "require-dev": {
+       "altis/local-server": "^17.0.0"
+    },
+    "config": {
+       "platform": {
+          "php": "8.1"
+       }
+    }
 }
 ```
 
-Once you have made these changes run `composer update` and then run
+Once you have made these changes, run `composer update` and then run
 the `wp altis migrate` command:
 
 ```sh
@@ -56,25 +56,40 @@ You can include it by adding it as a dependency in your
 top-level `composer.json` file.
 
 ```sh
-# Add Extended CPTs support
+# Add Altis Analytics support
 composer require altis/analytics
 ```
 
+If it is not already set, you will also need to add configuration for the
+module to your `composer.json` file. It is no longer enabled by default.
+
+```json
+{
+    "extra": {
+       "altis": {
+          "analytics": {
+             "enabled": true
+          }
+       }
+    }
+}
+```
+
 ### PHP 8.1
 
 PHP 8.1 is now our recommended version of PHP for Altis. We have improved
-support for it but note that there are a number of exceptions to
-compatability in the core WordPress CMS module. See the [WordPress
+support for it, but note that there are a number of exceptions to
+Compatibility in the core WordPress CMS module. See the [WordPress
 documentation on compatibility](https://make.wordpress.org/core/handbook/references/php-compatibility-and-wordpress-versions/)
 for more information.
 
 ### PHP 8.2 ###
 
 Altis v17 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
+environments. We have improved compatibility 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.
+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.
@@ -96,6 +111,14 @@ See
 the [WordPress 6.3 Field Guide](https://make.wordpress.org/core/2023/07/18/wordpress-6-3-field-guide/)
 for more information.
 
+### Altis Dashboard
+
+Though not strictly part of this release, you can now specify a custom branch
+for a non-production environment in the Altis Dashboard. You will need to have
+the "admin" instance role in Altis Dashboard.
+
+![](../assets/altis-dashboard-self-service-branches.gif)
+
 ### Altis Core improvements
 
 We have incorporated many updates to modules and libraries in Altis to bring in