Merge pull request #2032 from arin-deloatch/docs/LCORE-1651

LCORE-1651: Link to upgrade guidance and migration paths for each version

Author: tisnik

README.md

@@ -1404,6 +1404,8 @@ The version X.Y.Z indicates:
 * Y is the minor version (backward-compatible), and
 * Z is the patch version (backward-compatible bug fix).
 
+For upgrade instructions between versions, see the [Migration Guides](docs/migrations/).
+
 # Konflux
 
 The official image of Lightspeed Core Stack is built on [Konflux](https://konflux-ui.apps.kflux-prd-rh02.0fk9.p1.openshiftapps.com/ns/lightspeed-core-tenant/applications/lightspeed-stack).

docs/README.md

@@ -61,6 +61,10 @@ See the full documentation at [`../README.md`](../README.md) or browse sub-pages
 
 [Unsupported versions](https://lightspeed-core.github.io/lightspeed-stack/versions_unsupported.html)
 
+## Migration guides
+
+[Migration guides](https://lightspeed-core.github.io/lightspeed-stack/migrations/)
+
 ## Info for developers
 
 [Contributing guide](https://lightspeed-core.github.io/lightspeed-stack/contributing_guide.html)

docs/index.md

@@ -68,6 +68,10 @@ product questions using backend LLM services, agents, and RAG databases.
 
 [Unsupported versions](https://lightspeed-core.github.io/lightspeed-stack/versions_unsupported.html)
 
+## Migration guides
+
+[Migration guides](https://lightspeed-core.github.io/lightspeed-stack/migrations/)
+
 ## Info for developers
 
 [Contributing guide](https://lightspeed-core.github.io/lightspeed-stack/contributing_guide.html)

docs/migrations/index.md

@@ -0,0 +1,8 @@
+# Migration Guides
+
+This page lists upgrade and migration guides for each Lightspeed Core Stack
+release that includes breaking or notable configuration changes.
+
+| Version | Description |
+|---------|-------------|
+| [v0.7.0](v0.7.0.md) | RAG configuration restructured under a unified `rag` section |