Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Policies for stability #18

Merged
merged 2 commits into from
Mar 8, 2023
Merged

Policies for stability #18

merged 2 commits into from
Mar 8, 2023

Conversation

clux
Copy link
Member

@clux clux commented May 29, 2022

Policies for stability that is sufficient to meet Client Support Level; Stable according to the client requirements even though we are not 1.0.

This documents:

  • platform support (via our ci envs)
  • handwaves cloud provider support by pointing to conformance (and our kubernetes version support)
  • deprecation strategy (what we already do)
  • unstable feature strategy (what we already do)
  • interface change policy (what we already do)
  • talks about going forward towards 1.0 linking to Breaking Changes after 1.0 kube#923

this will mark most of the remaining checks on kube-rs/kube#726 as completed and will let us move out any remaining issues into more focused issues.

@clux clux marked this pull request as ready for review May 29, 2022 12:59
@clux clux requested review from kazk and nightkr May 29, 2022 13:00
docs/stability.md Outdated Show resolved Hide resolved
@clux

This comment was marked as resolved.

@clux

This comment was marked as outdated.

Signed-off-by: clux <[email protected]>

link to future stability policy discussion

Signed-off-by: clux <[email protected]>

create a kubernetes versioning matrix now

since we can't use kubernetes versioning post 1.0, there's no point
waiting. let's define and get clarity now.

Signed-off-by: clux <[email protected]>

potential solution for kubernetes version policy

Propose a 5 version range from [MAX-4, MAX], since this matches kubernetes upstream support.
This will need to go with better e2e tests.

Signed-off-by: clux <[email protected]>

remove kubernetes doc - moved into #19

Signed-off-by: clux <[email protected]>

update with unstable features

Signed-off-by: clux <[email protected]>
@clux
Copy link
Member Author

clux commented Mar 5, 2023

Updated to reflect reality. I think this would be a good thing to have because most of this actually reflects how we approach things (in particular w.r.t. deprecations/unstable features/interface changes/platform support).

It would be enough for us to change us to a "Stable Client" modulo the upstream requirements (which granted, are looser than no semver breaking changes).

Feedback on particular points here would be appreciated. This has sat here for too long and I hope it's not super controversial (although i expect there may be some points on the 1.0 stuff in there).

Copy link
Member

@nightkr nightkr left a comment

Choose a reason for hiding this comment

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

LGTM, but GH makee it a pain to view diffs between squashed commits

@clux clux merged commit 010c368 into main Mar 8, 2023
@clux clux deleted the stability branch March 8, 2023 02:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants