Merge pull request #1580 from StackVista/stac-22163-release-strategy

STAC-22163: draft release strategy

Author: deontaljaard

k8s-suse-rancher-prime.md

@@ -220,6 +220,13 @@ sts service-token create --name suse-observability-extension --roles stackstate-
 ```
 {% endcode %}
 
+### SUSE Observability Rancher UI extension compatibility matrix
+
+| UI Extension Version | Supported Rancher Version |
+|----------------------|---------------------------|
+| 0.x.x                | 2.8                       |
+| 1.x.x                | 2.9                       |
+| 2.x.x                | 2.10                      |
 
 ## Installing the SUSE Observability Agent
 

setup/release-notes/README.md

@@ -4,4 +4,59 @@ description: SUSE Observability Self-hosted
 
 # Release Notes
 
-Check the release notes for the latest features, enhancements, and bug fixes in StackState.
+Check the release notes for the latest features, enhancements, and bug fixes in SUSE Observability.
+
+# Release Strategy
+
+## Overview
+
+This section outlines the release strategy for SUSE Observability, including its core components:
+
+- SUSE Observability Platform (Helm Chart)
+- SUSE Observability Agents (Helm Chart)
+- SUSE Observability Rancher UI Extension
+
+The goal of this strategy is to ensure users always have access to the latest features, security updates, and
+compatibility across all components.
+
+## Release Cadence
+
+Each component follows a rolling release model, with no fixed cadence:
+
+- SUSE Observability Platform: Regularly updated to introduce new features, enhancements, and stability improvements.
+- SUSE Observability Agents: Released as frequently as necessary, especially for security patches and performance optimizations.
+- SUSE Observability Rancher UI Extension: Updated alongside major platform releases (Rancher and SUSE Observability) to maintain compatibility and user experience.
+
+## Compatibility Guidelines
+
+- The latest SUSE Observability Agent is always recommended, as it includes critical security fixes and performance improvements.
+- The latest Agent is compatible with all supported versions of the SUSE Observability Platform.
+- Users should ensure they are running the recommended version of the SUSE Observability Rancher UI Extension
+  corresponding to their Platform version.
+
+## Upgrade Recommendations
+
+### SUSE Observability Agents
+
+- Always upgrade to the latest version to benefit from security fixes and performance enhancements.
+- Agents are designed to be backward-compatible with all supported Platform versions.
+- Review release notes for an overview of changes made before upgrading.
+
+### SUSE Observability Platform
+
+- Upgrade to newer versions as they become available to gain access to new features and stability improvements.
+- Review release notes for potential breaking changes before upgrading.
+
+### SUSE Observability Rancher UI Extension
+
+- Ensure the UI extension version matches the recommended version for your Rancher deployment.
+    - See the UI extension and Rancher compatibility matrix [here](../../k8s-suse-rancher-prime.md#suse-observability-rancher-ui-extension-compatibility-matrix).
+- Upgrades and compatibility are typically aligned with Rancher and SUSE Observability platform releases.
+
+## Support Policy
+
+- Latest SUSE Observability Agent versions are fully supported.
+- Previous SUSE Observability Platform versions receive support for a defined period, typically covering the latest release and the two most recent patch versions. Upgrading to the latest version is strongly encouraged.
+- Security patches will be prioritized for the latest releases of all components.
+
+For questions or upgrade guidance, please reach out to our support team.