beenull/moby
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Extend deprecation cycle to 3 releases by default

Browse source 
At the moment docker's deprecation policy is 2 release cycles by
default, which is around 5 months. This may not be enough for
production environment and there is a need to extend the
deprecation cycle to 3 releases (see #24494).

This fix updates the docs/deprecated.md and extend the deprecation
cycle to 3 releases.

This fix is related to #24494 and #24534.

This fix fixes #24534.

Signed-off-by: Yong Tang <yong.tang.github@outlook.com>
This commit is contained in:
Yong Tang 2016-07-12 20:14:11 -07:00
parent 489adc96b8
commit 9414955c60
2 changed files with 8 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
docs/deprecated.md
View file

@ -13,6 +13,9 @@ weight=80
# Deprecated Engine Features # Deprecated Engine Features
The following list of features are deprecated in Engine. The following list of features are deprecated in Engine.
To learn more about Docker Engine's deprecation policy,
see [Feature Deprecation Policy](index.md#feature-deprecation-policy).
### Three argument form in `docker import` ### Three argument form in `docker import`
**Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)** **Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)**
@ -25,7 +28,7 @@ The `docker import` command format 'file|URL|- [REPOSITORY [TAG]]' is deprecated
**Deprecated In Release: [v1.12.0](https://github.com/docker/docker/releases/)** **Deprecated In Release: [v1.12.0](https://github.com/docker/docker/releases/)**
**Target For Removal In Release: [v1.14.0](https://github.com/docker/docker/releases/)** **Target For Removal In Release: v1.15**
The shorthand (`-h`) is less common than `--help` on Linux and cannot be used The shorthand (`-h`) is less common than `--help` on Linux and cannot be used
on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on
@ -35,14 +38,14 @@ on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on
### `-e` and `--email` flags on `docker login` ### `-e` and `--email` flags on `docker login`
**Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)**
**Target For Removal In Release: v1.13** **Target For Removal In Release: v1.14**
The docker login command is removing the ability to automatically register for an account with the target registry if the given username doesn't exist. Due to this change, the email flag is no longer required, and will be deprecated. The docker login command is removing the ability to automatically register for an account with the target registry if the given username doesn't exist. Due to this change, the email flag is no longer required, and will be deprecated.
### Separator (`:`) of `--security-opt` flag on `docker run` ### Separator (`:`) of `--security-opt` flag on `docker run`
**Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)**
**Target For Removal In Release: v1.13** **Target For Removal In Release: v1.14**
The flag `--security-opt` doesn't use the colon separator(`:`) anymore to divide keys and values, it uses the equal symbol(`=`) for consinstency with other similar flags, like `--storage-opt`. The flag `--security-opt` doesn't use the colon separator(`:`) anymore to divide keys and values, it uses the equal symbol(`=`) for consinstency with other similar flags, like `--storage-opt`.
@ -88,7 +91,7 @@ Use `docker ps --filter=before=...` and `docker ps --filter=since=...` instead.
**Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/)** **Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/)**
**Target For Removal In Release: v1.14** **Target For Removal In Release: v1.15**
The `docker search --automated` and `docker search --stars` options are deprecated. The `docker search --automated` and `docker search --stars` options are deprecated.
Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead. Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead.

2
docs/index.md
View file

@ -104,7 +104,7 @@ on the separate [Release Notes page](https://docs.docker.com/release-notes)
As changes are made to Docker there may be times when existing features As changes are made to Docker there may be times when existing features
will need to be removed or replaced with newer features. Before an existing will need to be removed or replaced with newer features. Before an existing
feature is removed it will be labeled as "deprecated" within the documentation feature is removed it will be labeled as "deprecated" within the documentation
and will remain in Docker for, usually, at least 2 releases. After that time and will remain in Docker for, usually, at least 3 releases. After that time
it may be removed. it may be removed.
Users are expected to take note of the list of deprecated features each Users are expected to take note of the list of deprecated features each