Skip to content
This repository was archived by the owner on Oct 13, 2023. It is now read-only.

Commit d444120

Browse files
committed
Include deprecation policy on deprecated features page
This section was included on a page on docs.docker.com, but not linked in the navigation. Putting the section on the deprecated features page to be sure they can be found together. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> (cherry picked from commit 99443274b1d169fb462b4dfa11a8c888d7422492) Signed-off-by: Sebastiaan van Stijn <github@gone.nl> Upstream-commit: 288cdec2919f6ee7c33002f8050ed8fa2b263c1c Component: cli
1 parent 7780c96 commit d444120

1 file changed

Lines changed: 18 additions & 3 deletions

File tree

components/cli/docs/deprecated.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,24 @@ keywords: "docker, documentation, about, technology, deprecate"
1515

1616
# Deprecated Engine Features
1717

18-
The following list of features are deprecated in Engine. To learn more about Docker
19-
Engine's deprecation policy, see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
18+
This page provides an overview of features that are deprecated in Engine. Changes
19+
in packaging, and supported (Linux) distributions are not included. To learn
20+
about end of support for Linux distributions, refer to the
21+
[release notes](https://docs.docker.com/engine/release-notes/).
22+
23+
## Feature Deprecation Policy
24+
25+
As changes are made to Docker there may be times when existing features need to
26+
be removed or replaced with newer features. Before an existing feature is removed
27+
it is labeled as "deprecated" within the documentation and remains in Docker for
28+
at least 3 stable releases unless specified explicitly otherwise. After that time
29+
it may be removed.
30+
31+
Users are expected to take note of the list of deprecated features each release
32+
and plan their migration away from those features, and (if applicable) towards
33+
the replacement features as soon as possible.
34+
35+
## Deprecated Engine Features
2036

2137
The table below provides an overview of the current status of deprecated features:
2238

@@ -522,4 +538,3 @@ of the `--changes` flag that allows to pass `Dockerfile` commands.
522538
**Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)**
523539

524540
The `docker import` command format `file|URL|- [REPOSITORY [TAG]]` is deprecated since November 2013. It's no more supported.
525-

0 commit comments

Comments
 (0)