Policy for removing features and API endpoints

Overview

https://docs.gitlab.com/omnibus/package-information/deprecation_policy.html only covers deprecating and removing configuration settings. What if I want to remove an API endpoint or a feature? At first glance, https://docs.gitlab.com/ee/development/deprecation_guidelines/ looks like where I'll find the policy for that, but if I scroll down to https://docs.gitlab.com/ee/development/deprecation_guidelines/#when-can-a-feature-be-removedchanged it sends me to https://docs.gitlab.com/ee/policy/maintenance.html which doesn't say anything about the process for removing features.

Proposal

  1. If a policy already exists, link to in in https://docs.gitlab.com/ee/development/deprecation_guidelines/#when-can-a-feature-be-removedchanged
  2. If a policy doesn't exist, create one.

cc @fseifoddini

Edited by Larissa Lane