@@ -11,13 +11,29 @@ changes](../contributing/index.md#breaking-changes) to GitLab features.
## Terminology
It's important to understand the difference between **deprecation** and
**removal**:
**Deprecation**:
**Deprecation** is the process of flagging/marking/announcing that a feature is no longer fully supported and may be removed in a future version of GitLab.
- Feature not recommended for use.
- Development restricted to Priority 1 / Severity 1 bug fixes.
- Will be removed in a future major release.
- Begins after a deprecation announcement outlining an end-of-support date.
- Ends after the end-of-support date or removal date has passed.
**Removal** is the process of actually removing a feature that was previously