Add REST API style guide for deprecations

Chance Feickrequested to merge
581045-deprecated-styleguide into master

What does this MR do and why?

Add section to REST API style guide for deprecations. Follow-up to !214743 (comment 2926302043).

References

MR acceptance checklist

Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.

Related to #581045 (closed)

Merge request reports