From d2a2362be57629fa0c494c2ce2cac1cc3074b6fd Mon Sep 17 00:00:00 2001
From: Douglas De Toni Machado <douglas.machado@traefik.io>
Date: Thu, 24 Mar 2022 08:28:07 -0300
Subject: [PATCH]  Add a Feature Deprecation page

---
 docs/content/deprecation/features.md | 20 ++++++++++++++++++++
 docs/content/migration/v2.md         |  2 +-
 docs/mkdocs.yml                      |  1 +
 3 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 docs/content/deprecation/features.md

diff --git a/docs/content/deprecation/features.md b/docs/content/deprecation/features.md
new file mode 100644
index 000000000..6c277c841
--- /dev/null
+++ b/docs/content/deprecation/features.md
@@ -0,0 +1,20 @@
+# Feature Deprecation Notices
+
+This page is maintained and updated periodically to reflect our roadmap and any decisions around feature deprecation.
+
+| Feature                                               | Deprecated | End of Support | Removal |
+|-------------------------------------------------------|------------|----------------|---------|
+| [Pilot Dashboard (Metrics)](#pilot-dashboard-metrics) | 2.7        | 2.8            | 2.9     |
+| [Pilot Plugins](#pilot-plugins)                       | 2.7        | 2.8            | 2.9     |
+
+## Impact
+
+### Pilot Dashboard (Metrics)
+
+Metrics will continue to function normally up to 2.8, when they will be disabled.  
+In 2.9, the Pilot platform and all Traefik integration code will be permanently removed.
+
+### Pilot Plugins 
+
+Starting on 2.7 the pilot token will not be a requirement anymore.  
+At 2.9, a new plugin catalog home should be available, decoupled from pilot.
diff --git a/docs/content/migration/v2.md b/docs/content/migration/v2.md
index 01ac943b6..e74dba10c 100644
--- a/docs/content/migration/v2.md
+++ b/docs/content/migration/v2.md
@@ -458,4 +458,4 @@ In `v2.6.1`, the Datadog tags added to a span changed from `service.name` to `tr
 ### Traefik Pilot
 
 In `v2.7`, the `pilot.token` and `pilot.dashboard` options are deprecated.
-Please check our Blog for migration instructions later this year.
+Please check the [feature deprecation page](../deprecation/features.md) and our Blog for migration instructions later this year.
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index cc021cbe2..438c9a194 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -199,3 +199,4 @@ nav:
         - 'Rancher': 'reference/dynamic-configuration/rancher.md'
   - 'Deprecation Notices':
       - 'Releases': 'deprecation/releases.md'
+      - 'Features': 'deprecation/features.md'