Merge pull request #8383 from oscr/add-1.5-migration-docs

📖 Add 1.4 -> 1.5 migrations doc. Move migrations docs to single folder.

Author: k8s-ci-robot

docs/book/src/SUMMARY.md

@@ -80,12 +80,13 @@
         - [Support multiple instances](./developer/architecture/controllers/support-multiple-instances.md)
     - [Provider Implementers](./developer/providers/implementers.md)
         - [Version migration](./developer/providers/version-migration.md)
-          - [v0.3 to v0.4](./developer/providers/v0.3-to-v0.4.md)
-          - [v0.4 to v1.0](./developer/providers/v0.4-to-v1.0.md)
-          - [v1.0 to v1.1](./developer/providers/v1.0-to-v1.1.md)
-          - [v1.1 to v1.2](./developer/providers/v1.1-to-v1.2.md)
-          - [v1.2 to v1.3](./developer/providers/v1.2-to-v1.3.md)
-          - [v1.3 to v1.4](./developer/providers/v1.3-to-v1.4.md)
+          - [v0.3 to v0.4](./developer/providers/migrations/v0.3-to-v0.4.md)
+          - [v0.4 to v1.0](./developer/providers/migrations/v0.4-to-v1.0.md)
+          - [v1.0 to v1.1](./developer/providers/migrations/v1.0-to-v1.1.md)
+          - [v1.1 to v1.2](./developer/providers/migrations/v1.1-to-v1.2.md)
+          - [v1.2 to v1.3](./developer/providers/migrations/v1.2-to-v1.3.md)
+          - [v1.3 to v1.4](./developer/providers/migrations/v1.3-to-v1.4.md)
+          - [v1.4 to v1.5](./developer/providers/migrations/v1.4-to-v1.5.md)
         - [Provider contracts](./developer/providers/contracts.md)
           - [Cluster Infrastructure](./developer/providers/cluster-infrastructure.md)
           - [Machine Infrastructure](./developer/providers/machine-infrastructure.md)

docs/book/src/developer/providers/v0.3-to-v0.4.md renamed to docs/book/src/developer/providers/migrations/v0.3-to-v0.4.md

@@ -0,0 +1,34 @@
+# Cluster API v1.4 compared to v1.5
+
+This document provides an overview over relevant changes between Cluster API v1.4 and v1.5 for
+maintainers of providers and consumers of our Go API.
+
+## Minimum Go version
+
+- The Go version used by Cluster API is still Go 1.19.x
+
+## Dependencies
+
+**Note**: Only the most relevant dependencies are listed, `k8s.io/` and `ginkgo`/`gomega` dependencies in Cluster API are kept in sync with the versions used by `sigs.k8s.io/controller-runtime`.
+
+## Changes by Kind
+
+### Deprecation
+
+-
+
+### Removals
+
+-
+
+### API Changes
+
+-
+
+### Other
+
+- 
+
+### Suggested changes for providers
+
+- 

docs/book/src/developer/providers/v0.4-to-v1.0.md renamed to docs/book/src/developer/providers/migrations/v0.4-to-v1.0.md

@@ -3,9 +3,10 @@
 The following pages provide an overview of relevant changes between versions of Cluster API and their direct successors. These guides are intended to assist 
 maintainers of other providers and consumers of the Go API in upgrading from one version of Cluster API to a subsequent version.
 
-- [v0.3 to v0.4](v0.3-to-v0.4.md)
-- [v0.4 to v1.0](v0.4-to-v1.0.md)
-- [v1.0 to v1.1](v1.0-to-v1.1.md)
-- [v1.1 to v1.2](v1.1-to-v1.2.md)
-- [v1.2 to v1.3](v1.2-to-v1.3.md)
-- [v1.3 to v1.4](v1.3-to-v1.4.md)
+- [v0.3 to v0.4](migrations/v0.3-to-v0.4.md)
+- [v0.4 to v1.0](migrations/v0.4-to-v1.0.md)
+- [v1.0 to v1.1](migrations/v1.0-to-v1.1.md)
+- [v1.1 to v1.2](migrations/v1.1-to-v1.2.md)
+- [v1.2 to v1.3](migrations/v1.2-to-v1.3.md)
+- [v1.3 to v1.4](migrations/v1.3-to-v1.4.md)
+- [v1.4 to v1.5](migrations/v1.4-to-v1.5.md)