diff options
| author | Kubernetes Submit Queue <k8s-merge-robot@users.noreply.github.com> | 2017-10-17 11:16:35 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-10-17 11:16:35 -0700 |
| commit | 016d329ea7d2b81e273b7d209ec5b28407aef21a (patch) | |
| tree | c23e7b32316b3ee1ccc5ab345e162952906d6ad6 | |
| parent | 0c811988607648c726b3d940e5335fe864da3f0b (diff) | |
| parent | 333cf0d960950f2ae87417d46c23e853e63d952d (diff) | |
Merge pull request #1160 from php-coder/no_extensions_api
Automatic merge from submit-queue.
api_changes.md: don't suggest to create API in extensions group
As per https://github.com/kubernetes/kubernetes/issues/43214 we shouldn't use `extensions` API group. This PR removed suggestions about using it as a starting point for a new API.
PTAL @soltysh
CC @simo5
| -rw-r--r-- | contributors/devel/api_changes.md | 7 |
1 files changed, 1 insertions, 6 deletions
diff --git a/contributors/devel/api_changes.md b/contributors/devel/api_changes.md index d4942907..924f8735 100644 --- a/contributors/devel/api_changes.md +++ b/contributors/devel/api_changes.md @@ -37,8 +37,7 @@ found at [API Conventions](api-conventions.md). Before attempting a change to the API, you should familiarize yourself with a number of existing API types and with the [API conventions](api-conventions.md). If creating a new API type/resource, we also recommend that you first send a PR -containing just a proposal for the new API types, and that you initially target -the extensions API (pkg/apis/extensions). +containing just a proposal for the new API types. The Kubernetes API has two major components - the internal structures and the versioned APIs. The versioned APIs are intended to be stable, while the @@ -322,15 +321,11 @@ If you found that your change accidentally broke clients, it should be reverted. In short, the expected API evolution is as follows: -* `extensions/v1alpha1` -> * `newapigroup/v1alpha1` -> ... -> `newapigroup/v1alphaN` -> * `newapigroup/v1beta1` -> ... -> `newapigroup/v1betaN` -> * `newapigroup/v1` -> * `newapigroup/v2alpha1` -> ... -While in extensions we have no obligation to move forward with the API at all -and may delete or break it at any time. - While in alpha we expect to move forward with it, but may break it. Once in beta we will preserve forward compatibility, but may introduce new |