[MESOS-4192] Add documentation for API Versioning

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.27.0
• Component/s: documentation
• Labels: documentation mesosphere
• Epic Link: Scheduler API v1 improvements
• Sprint: Mesosphere Sprint 25
• Story Points: 3
• Assignee: Anand Mazumdar
• Reporter: Anand Mazumdar
• Shepherd: Vinod Kone
• Created: 17/Dec/15 19:59
• Updated: 26/Nov/18 12:21
• Resolved: 26/Nov/18 12:21

Description

Currently, we don't have any documentation for:

• How Mesos implements API versioning ?
• How are protobufs versioned and how does mesos handle them internally ?
• What do contributors need to do when they make a change to a external user facing protobuf ?

The relevant design doc:
https://docs.google.com/document/d/1-iQjo6778H_fU_1Zi_Yk6szg8qj-wqYgVgnx7u3h6OU/edit#heading=h.2gkbjz6amn7b

Issue Links

• is related to: MESOS-3995 Document Mesos release, upgrade, deprecation policy