Skip to content

Conversation

lfrancke
Copy link
Member

No description provided.

Copy link

netlify bot commented Sep 30, 2025

Deploy Preview for stackable-docs ready!

Name Link
🔨 Latest commit 1e805e8
🔍 Latest deploy log https://app.netlify.com/projects/stackable-docs/deploys/68de8d000e1d1c0008d33f98
😎 Deploy Preview https://deploy-preview-784--stackable-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@lfrancke lfrancke moved this to Development: Waiting for Review in Stackable Engineering Sep 30, 2025
sbernauer
sbernauer previously approved these changes Sep 30, 2025
@sbernauer sbernauer moved this from Development: Waiting for Review to Development: In Review in Stackable Engineering Sep 30, 2025
@razvan
Copy link
Member

razvan commented Sep 30, 2025

IMO the extremly personal style of this text damages clarity and simplicity. I mean formulations like "our products", "your Kubernetes resources" are pretty vague and don't read very professional.

Also there is a bit of callout inflation, like for example:

This policy concerns releases of our platform as a whole and how long and to which extent we support each version.

As a reader I have to wonder: as opposed to what?

I know this is a a bit of style preference so I don't expect you to agree.

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

An SDP release contains our operators and other code developed at Stackable as well as the product docker images.
An SDP release contains our operators and other code developed at Stackable as well as the data product docker images.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion: Remove the term "docker" here.

Suggested change
An SDP release contains our operators and other code developed at Stackable as well as the data product docker images.
An SDP release contains our operators and other code developed at Stackable as well as the data product container images.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 1e805e8

== CRD Versioning lifecycle policy

IMPORTANT: As of January 2024 all our CRDs are versioned as `alpha1`. We will start introducing other versions later
IMPORTANT: As of release 25.7 all our CRDs are versioned as `alpha1`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note: This needs to say v1alpha1.

Suggested change
IMPORTANT: As of release 25.7 all our CRDs are versioned as `alpha1`.
IMPORTANT: As of release 25.7 all our CRDs are versioned as `v1alpha1`.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 1e805e8

@lfrancke
Copy link
Member Author

lfrancke commented Oct 2, 2025

I believe I have fixed all comments and also tried to address some of the feedback from @razvan.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Development: In Review
Development

Successfully merging this pull request may close these issues.

6 participants