Merge pull request #590 from humanmade/backport-589-to-v21-branch

[Backport v21-branch] Add v21 upgrade guide

other-docs/guides/upgrading/README.md

@@ -12,16 +12,16 @@ specific version you are upgrading to. When upgrading multiple versions at once,
 all intermediate versions.
 
 To switch the version of Altis for your project, modify the version constraint for the `altis/altis` dependency in
-your `composer.json`. For example, to upgrade to Altis version 20.
+your `composer.json`. For example, to upgrade to Altis version 21.
 
 ```json
 {
     "name": "company-name/my-site",
     "require": {
-        "altis/altis": "^20.0.0"
+        "altis/altis": "^21.0.0"
     },
     "require-dev": {
-        "altis/local-server": "^20.0.0"
+        "altis/local-server": "^21.0.0"
     }
 }
 ```
@@ -32,7 +32,7 @@ Next run `rm -rf vendor` on MacOS or Linux, or on Windows `rmdir vendor`.
 latest version of the package is used during the upgrade process. We are working to improve this process in future
 releases.
 
-Next, run `composer update` to pull in the latest version of the packages.
+Next, run `composer update -W   ` to pull in the latest version of the packages.
 
 This will generate a new `composer.lock` file. Both the `composer.json` and `composer.lock` should be committed to
 version control, and deployed.
@@ -43,6 +43,7 @@ with "BREAKING: " in the version release notes.
 
 ## Upgrade Guides
 
+- [Version 21](./v21.md)
 - [Version 20](./v20.md)
 - [Version 19](./v19.md)
 - [Version 18](./v18.md)

other-docs/guides/upgrading/v21.md

@@ -0,0 +1,91 @@
+---
+order: 21
+---
+
+# Upgrading to v21
+
+*If you are migrating from WordPress to Altis, check out the [migrating guide](../migrating/) first.*
+
+To upgrade to Altis v21, edit your `composer.json` and change the version constraint for `altis/altis` and any local environment
+modules to `^21.0.0`.
+
+```json
+{
+    "require": {
+        "altis/altis": "^21.0.0"
+    },
+    "require-dev": {
+        "altis/local-server": "^21.0.0"
+    },
+    "config": {
+        "platform": {
+            "php": "8.2"
+        }
+    }
+}
+```
+
+Once you have made these changes, run `composer update` and then run the `wp altis migrate` command:
+
+```sh
+# For cloud environments
+wp altis migrate
+
+# For local server
+composer server cli -- altis migrate
+```
+
+## Breaking Changes
+
+## Changes to the Altis platform
+
+Altis Local Server no longer supports MySQL version 5.7. Please make sure to back up your database before upgrading. The database
+will be upgraded automatically and we don't expect any issue, but it is always prudent to have a backup.
+
+## PHP
+
+We continue with our experimental support for PHP 8.3. This is not yet recommended for production use, but you can test
+your code with PHP 8.3 in [Local Server](docs://local-server/).
+
+Refer to our [PHP Version Guide](docs://guides/updating-php/) for up-to-date compatibility, testing and upgrading information.
+
+## Headline Features
+
+### Node.js
+
+We continue to improve Altis support for Node.js applications alongside WordPress. This is an experimental feature, you can enable
+it in Local Server, and we welcome feedback.
+
+### WordPress 6.7
+
+WordPress 6.7 brings lots of new features, bug fixes, and improvements across the board. In particular, there are improvements
+in performance and accessibility, and exciting new features for the block editor. A brand-new default theme, Twenty
+Twenty-Five makes its debut in this release. Additionally, there have been many theming improvements of interest to theme
+developers and designers.
+
+For developers, updates to the Interactivity API, including a new way to interact with server state changes in client-side
+navigation, and improvements for loading existing scripts as module dependencies.
+
+See the
+[WordPress 6.7 Field Guide](https://make.wordpress.org/core/2024/10/23/wordpress-6-7-field-guide/) for more information.
+
+### WordPress CLI 2.11
+
+We updated WP CLI to version 2.11. This brings new features and bug fixes, including the ability to manage your signup list, manage
+unknown image sizes, an `i18n make-php` command and multisite commands now can specify `--slug`.
+
+### Altis Core improvements
+
+### Backup shipping add-on
+
+Altis Cloud now offers Backup Shipping, an add-on service designed for customers requiring off-site backup storage for compliance
+and disaster recovery. Adhering to the industry-standard 3-2-1 rule, this feature enables users to retain three copies of data
+across two storage types, with one copy stored off-site. Contact your account manager for more information.
+
+As always, we continue to incorporated updates and security fixes to modules and libraries in Altis to bring in important bug fixes
+and improvements.
+
+### Documentation
+
+Our developer focused 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]).