Merge pull request #2401 from thaJeztah/19.03_backport_deprecation_policy

[19.03 backport] Include deprecation policy on deprecated features page
This commit is contained in:
Silvin Lubecki 2020-03-20 11:50:53 +01:00 committed by GitHub
commit 0b0ea3f0fa
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 3 deletions

View File

@ -15,8 +15,24 @@ keywords: "docker, documentation, about, technology, deprecate"
# Deprecated Engine Features
The following list of features are deprecated in Engine. To learn more about Docker
Engine's deprecation policy, see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
This page provides an overview of features that are deprecated in Engine. Changes
in packaging, and supported (Linux) distributions are not included. To learn
about end of support for Linux distributions, refer to the
[release notes](https://docs.docker.com/engine/release-notes/).
## Feature Deprecation Policy
As changes are made to Docker there may be times when existing features need to
be removed or replaced with newer features. Before an existing feature is removed
it is labeled as "deprecated" within the documentation and remains in Docker for
at least 3 stable releases unless specified explicitly otherwise. After that time
it may be removed.
Users are expected to take note of the list of deprecated features each release
and plan their migration away from those features, and (if applicable) towards
the replacement features as soon as possible.
## Deprecated Engine Features
The table below provides an overview of the current status of deprecated features:
@ -522,4 +538,3 @@ of the `--changes` flag that allows to pass `Dockerfile` commands.
**Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)**
The `docker import` command format `file|URL|- [REPOSITORY [TAG]]` is deprecated since November 2013. It's no more supported.