[MESOS-8645] Scheduler HTTP API calls for Accepting/Declining inverse offers lacks some documentation

• Type: Documentation
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: documentation
• Labels: mesosphere
• Epic Link: maintenance-improvements
• Assignee: Unassigned
• Reporter: Joseph Wu
• Created: 07/Mar/18 18:02
• Updated: 07/Mar/18 18:02

Description

This issue refers to documentation like:
https://github.com/apache/mesos/blob/master/docs/scheduler-http-api.md#accept

(The .proto file includes in-line documentation about the inverse offer calls.)

The markdown version of HTTP API documentation typically includes an example call body and some more details about the implications of the call(s); and recommendations of each call(s)' usage.