Add latest changes from gitlab-org/gitlab@13-3-stable-ee

1 files changed, 23 insertions, 0 deletions

diff --git a/doc/development/deprecation_guidelines/index.md b/doc/development/deprecation_guidelines/index.md
new file mode 100644
index 00000000000..1ee22644bbc
--- /dev/null
+++ b/doc/development/deprecation_guidelines/index.md
@@ -0,0 +1,23 @@
+# Deprecation guidelines
+
+This page includes information about how and when to remove or make breaking
+changes to GitLab features.
+
+## Terminology
+
+It's important to understand the difference between **deprecation** and
+**removal**:
+
+**Deprecation** is the process of flagging/marking/announcing that a feature
+will be removed in a future version of GitLab.
+
+**Removal** is the process of actually removing a feature that was previously
+deprecated.
+
+## When can a feature be deprecated?
+
+A feature can be deprecated at any time, provided there is a viable alternative.
+
+## When can a feature be removed/changed?
+
+See our [Release and Maintenance policy](../../policy/maintenance.md).