Skip to content

Commit 1e805e8

Browse files
committed
Address review feedback
1 parent 66aab27 commit 1e805e8

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

modules/ROOT/pages/policies.adoc

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
= Lifecycle policies
22
:description: Detailed lifecycle policies for Stackable Data Platform, covering SDP, CRD versioning, product support, and compatibility with Kubernetes & OpenShift.
33

4-
This page details our lifecycle policies around various parts of our product - the Stackable Data Platform (SDP).
4+
This page details lifecycle policies for the Stackable Data Platform (SDP).
55

6-
We define multiple lifecycle policies for different parts of our platform, but all policies follow some common goals:
6+
Multiple lifecycle policies are defined for different parts of our platform, but all policies follow some common goals:
77

8-
* It should always be possible to upgrade to a new version of SDP without also changing any of your Kubernetes resources as long as you are not currently using anything that has already been marked as deprecated
8+
* It should always be possible to upgrade to a new version of SDP without also changing any of the Stackable Custom Resources as long as you are not currently using anything that has already been marked as deprecated
99
** This means you can upgrade the control plane independently of the user-facing products
1010
* All deprecations follow a predictable lifecycle that allows planning of upgrades ahead of time
1111
@@ -16,14 +16,12 @@ The guarantees we give are on multiple levels as detailed below:
1616
* Supported product versions
1717
* Supported OpenShift & Kubernetes versions
1818
19-
All these policies may evolve as we learn what works best for our customers and for us.
19+
These policies may evolve based on customer feedback and operational experience.
2020

2121
These policies were last updated in *September 2025*.
2222

2323
== Stackable Data Platform lifecycle policy
2424

25-
NOTE: This policy concerns releases of our platform as a whole and how long and to which extent we support each version.
26-
2725
We do releases of our Stackable Data Platform.
2826
These releases get a name based on the year and month they have been released in (e.g. `25.3`, `25.7`, also called https://calver.org/[CalVer{external-link-icon}^]).
2927
This name does not follow Semantic Versioning (https://semver.org/[SemVer{external-link-icon}^]).
@@ -32,7 +30,7 @@ See below for our policy on patches for the SDP.
3230

3331
We support an SDP release for a specific amount of time after its initial release.
3432

35-
An SDP release contains our operators and other code developed at Stackable as well as the data product docker images.
33+
An SDP release contains our operators, other components developed at Stackable, and the operator-managed product container images.
3634

3735
TIP: Our policy is inspired by the https://kubernetes.io/releases/patch-releases/[Kubernetes{external-link-icon}^] and the https://access.redhat.com/support/policy/updates/openshift#ocp4[OpenShift{external-link-icon}^] policies.
3836

@@ -74,8 +72,8 @@ While they may work in some cases, customers who downgrade do so at their own ri
7472

7573
== CRD Versioning lifecycle policy
7674

77-
IMPORTANT: As of release 25.7 all our CRDs are versioned as `alpha1`.
78-
Starting with release 25.11 we will introduce versioned CRDs (beta/stable) for some products.
75+
IMPORTANT: As of release 25.7 all our CRDs are versioned as `v1alpha1`.
76+
Starting with release 25.11 we will introduce versioned CRDs for some products.
7977

8078
CustomResourceDefinitions at Stackable are versioned.
8179

@@ -125,7 +123,7 @@ When introducing a new LTS release line, the previous LTS line must remain avail
125123
For example: If an LTS version is introduced in release 24.3 (March 2024), it must be available as the recommended LTS through at least the March 2025 release (25.3).
126124
If a new LTS is introduced in 25.3, the old LTS from 24.3 must remain available but deprecated in 25.3, and can be removed in the following release (25.7).
127125

128-
Which line we choose as our LTS release is at our own discretion and is based on popularity, upstream lifecycle policies, stability, our own experience and other factors.
126+
The line designated as our LTS release is chosen at our own discretion and is based on popularity, upstream lifecycle policies, stability, our own experience and other factors.
129127

130128
In addition to the LTS line we may also ship other versions, e.g. the latest upstream version.
131129

0 commit comments

Comments
 (0)