From 99443274b1d169fb462b4dfa11a8c888d7422492 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Fri, 20 Mar 2020 10:40:56 +0100 Subject: [PATCH] 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 --- docs/deprecated.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/deprecated.md b/docs/deprecated.md index 548bdd539f..ef636b2f63 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -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: @@ -525,4 +541,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. -