Clarify in REST API developer docs what constitutes a breaking change
This issue was created from this comment https://gitlab.com/gitlab-org/manage/manage-workspace/discussions/-/issues/40#note_1097996412.
We define what is a breaking change very well in our GraphQL API developer docs but there is not anything similar in our REST API developer docs.
We should add a similar section to the REST API docs to help developers to identify what is a breaking change.
Edited by Luke Duncalfe