We've added documentation about the API lifecycle to our DevNet docs. You can read more about how we use terms like "deprecate" and "sunset" as well as find a timeline of deprecated operations and suggested alternatives.
We hope this helps you identify the best possible operations to use for your use case and as always invite your feedback.
