Reorganize "Update and migration" (#2519)

---------

Co-authored-by: Marek Nocoń <[email protected]>

(cherry picked from commit ac53a56)

Author: adriendupuis

docs/update_and_migration/from_2.5/to_3.3.latest.md

@@ -152,6 +152,10 @@ Add the following rewrite rule to your web server configuration:
     rewrite "^/build/(.*)" "/build/$1" break;
     ```
 
-## Next steps
+## 6. Update the database
 
-Now, proceed to the last step, [updating to the latest v3.3 patch version](to_3.3.latest.md).
+[[% include 'snippets/update/db/update_db_2.5-3.3.md' %]]
+
+## 7. Update to the latest patch version
+
+Now, proceed to the last step, [updating to the latest v3.3 patch version](update_from_3.3.md).

docs/update_and_migration/from_2.5/to_3.3.md

@@ -16,6 +16,6 @@ Afterwards, it is strongly recommended to also [update to the latest v4.6 LTS](t
 1. [Update the app](to_3.2.md#3-update-the-app)
 1. [Update code to v3](adapt_code_to_v3.md)
 1. [Update to v3.3](to_3.3.md)
-1. [Update the database](to_3.3.latest.md#6-update-the-database)
-1. [Update to the latest patch version](to_3.3.latest.md#7-update-to-the-latest-patch-version)
-1. [Finish the update](to_3.3.latest.md#8-finish-the-update)
+1. [Update the database](to_3.3.md#6-update-the-database)
+1. [Update to the latest patch version](update_from_3.3.md)
+1. [Finish the update](update_from_3.3.md#finish-the-update)

docs/update_and_migration/from_2.5/update_from_2.5.md

@@ -5,6 +5,7 @@ description: Update your installation to the latest v3.3 version from an earlier
 # Update from v3.3.x to v3.3.latest
 
 This update procedure applies if you are using a v3.3 installation without the latest maintenance release.
+To update from an 3.2 to 3.3, see [Updating the app to v3.3](to_3.3.md). From older version, explore [this section](update_ibexa_dxp.md).
 
 Go through the following steps to update to the latest maintenance release of v3.3 (v[[= latest_tag_3_3 =]]).
 
@@ -439,3 +440,9 @@ Run the following scripts:
 ### v3.3.40
 
 A command to deal with duplicated database entries, as reported in [IBX-8562](https://issues.ibexa.co/browse/IBX-8562), will be available soon.
+
+## Finish the update
+
+[[% include 'snippets/update/finish_the_update.md' %]]
+
+[[% include 'snippets/update/notify_support.md' %]]

docs/update_and_migration/from_3.3/update_from_3.3.md

@@ -240,56 +240,6 @@ php bin/console ibexa:migrations:import vendor/ibexa/order-management/src/bundle
 php bin/console ibexa:migrations:migrate --file=order_permissions.yaml
 ```
 
-### v4.5.2
+## Update to v4.5.latest
 
-#### Database update
-
-Run the following scripts:
-
-=== "MySQL"
-
-    ``` bash
-    mysql -u <username> -p <password> <database_name> < vendor/ibexa/installer/upgrade/db/mysql/ibexa-4.5.1-to-4.5.2.sql
-    ```
-
-=== "PostgreSQL"
-
-    ``` bash
-    psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-4.5.1-to-4.5.2.sql
-    ```
-
-### v4.5.3
-
-#### Database update [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]]
-
-Run the following scripts:
-
-=== "MySQL"
-
-    ``` bash
-    mysql -u <username> -p <password> <database_name> < vendor/ibexa/installer/upgrade/db/mysql/ibexa-4.5.2-to-4.5.3.sql
-    ```
-
-=== "PostgreSQL"
-
-    ``` bash
-    psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-4.5.2-to-4.5.3.sql
-    ```
-
-### v4.5.4
-
-#### Database update
-
-Run the following scripts:
-
-=== "MySQL"
-
-    ``` bash
-    mysql -u <username> -p <password> <database_name> < vendor/ibexa/installer/upgrade/db/mysql/ibexa-4.5.3-to-4.5.4.sql
-    ```
-
-=== "PostgreSQL"
-
-    ``` bash
-    psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-4.5.3-to-4.5.4.sql
-    ```
+You can now continue applying the instructions for the 4.5 patch releases, starting with [v4.5.2](update_from_4.5.md#v452).