Add upgrade notes for v0.7.0-alpha.5

docs/guides/upgrading/.pages

@@ -1,6 +1,7 @@
 title: Upgrade guides
 nav:
   - index.md
+  - v0.7.0-alpha.5.md
   - v0.7.0-alpha.4.md
   - v0.7.0-alpha.3.md
   - v0.6.0.md

docs/guides/upgrading/v0.7.0-alpha.3.md

@@ -117,22 +117,6 @@
   * The new datasource configuration mechanism is documented in the
     [datasource configuration reference](../../reference/configuration/datasources.md).
 
-* **Loading secrets from files now uses the `${file::}` expression syntax.** The legacy
-  `<key>.file=/path` and `alpine.<key>.file=/path` properties are no longer recognized, and
-  the API server refuses to start if any of them are set. Rewrite each occurrence as
-  `<key>=${file::/path}`. Affected properties:
-
-    | Before                                                               | After                                   |
-    |:---------------------------------------------------------------------|:----------------------------------------|
-    | `dt.database.password.file` (or `alpine.database.password.file`)     | `dt.datasource.password=${file::/path}` |
-    | `dt.http.proxy.password.file` (or `alpine.http.proxy.password.file`) | `dt.http.proxy.password=${file::/path}` |
-    | `dt.ldap.bind.password.file` (or `alpine.ldap.bind.password.file`)   | `dt.ldap.bind.password=${file::/path}`  |
-
-    The file is read once at startup, decoded as UTF-8, and trailing whitespace is stripped.
-    Files larger than 64 KiB are rejected. Refer to
-    [Loading values from files](../../reference/configuration/application.md#loading-values-from-files)
-    for details.
-
 * **All configuration properties have been standardized to use the `dt.` prefix**.
   Properties that previously used the `alpine.` prefix, or no prefix at all, are now under `dt.`.
   For example:

docs/guides/upgrading/v0.7.0-alpha.4.md

@@ -8,3 +8,18 @@
   could not be completed in time for the GA release.
 * **Support for importing CycloneDX BOMs in Protobuf format has been removed**. JSON and XML remain
   the only accepted formats.
+* **Loading secrets from files now uses the `${file::}` expression syntax.** The legacy
+  `<key>.file=/path` and `alpine.<key>.file=/path` properties are no longer recognized, and
+  the API server refuses to start if any of them are set. Rewrite each occurrence as
+  `<key>=${file::/path}`. Affected properties:
+
+    | Before                                                               | After                                   |
+    |:---------------------------------------------------------------------|:----------------------------------------|
+    | `dt.database.password.file` (or `alpine.database.password.file`)     | `dt.datasource.password=${file::/path}` |
+    | `dt.http.proxy.password.file` (or `alpine.http.proxy.password.file`) | `dt.http.proxy.password=${file::/path}` |
+    | `dt.ldap.bind.password.file` (or `alpine.ldap.bind.password.file`)   | `dt.ldap.bind.password=${file::/path}`  |
+
+    The file is read once at startup, decoded as UTF-8, and trailing whitespace is stripped.
+    Files larger than 64 KiB are rejected. Refer to
+    [Loading values from files](../../reference/configuration/application.md#loading-values-from-files)
+    for details.

docs/guides/upgrading/v0.7.0-alpha.5.md

@@ -0,0 +1,10 @@
+# Upgrading to v0.7.0-alpha.5
+
+!!! warning
+    Please make sure you successfully upgraded to [v0.7.0-alpha.4](v0.7.0-alpha.4.md)
+    before upgrading to v0.7.0-alpha.5. This is **extremely important**, as otherwise
+    some database migrations will not be applied.
+
+* **Database migrations have been switched from Liquibase to Flyway**. No action is
+  required, *except ensuring that the [v0.7.0-alpha.4](v0.7.0-alpha.4.md) upgrade
+  was executed*.