----------------------------------------------------------- This is an automatically generated e-mail. To reply, visit: https://reviews.apache.org/r/41661/#review111689 -----------------------------------------------------------
docs/versioning.md (line 20) <https://reviews.apache.org/r/41661/#comment171918> 1) work or works? 2) s/work ?/work? docs/versioning.md (line 22) <https://reviews.apache.org/r/41661/#comment171920> Not yours, but can you please add the following to "Terminology" section? Scheduler API Executor API Internal API Operator API I did not get any explanation for those APIs except from a slides shared by @vinod in Seattle conference http://www.slideshare.net/mesosphere/mesos-http-api docs/versioning.md (line 36) <https://reviews.apache.org/r/41661/#comment171921> Not clear for what does " It would be really hard to debug an error that happens with Scheduler v2 API, Executor v4 API interacting with Mesos cluster running Internal v6 API and Operator v7 API." mean? I think that even with API versioning, this problem is still difficult to debug, how can the API version help this issue? - Guangya Liu On 十二月 22, 2015, 10:57 p.m., Anand Mazumdar wrote: > > ----------------------------------------------------------- > This is an automatically generated e-mail. To reply, visit: > https://reviews.apache.org/r/41661/ > ----------------------------------------------------------- > > (Updated 十二月 22, 2015, 10:57 p.m.) > > > Review request for mesos, Neil Conway and Vinod Kone. > > > Bugs: MESOS-4192 > https://issues.apache.org/jira/browse/MESOS-4192 > > > Repository: mesos > > > Description > ------- > > This change adds documentation on how Mesos does API versioning. It also has > a section: > - On how API versioning and Release versioning are different. > - API compatibility/upgrade guarantees. > - Implementation Details. > > Most of the information is taken from the design doc on Mesos HTTP API > Versioning: > https://docs.google.com/document/d/1-iQjo6778H_fU_1Zi_Yk6szg8qj-wqYgVgnx7u3h6OU/edit# > > > Diffs > ----- > > docs/home.md 51c19bb9d0d74698fcdda6197d32ed8f4a57d7c9 > docs/versioning.md PRE-CREATION > > Diff: https://reviews.apache.org/r/41661/diff/ > > > Testing > ------- > > https://gist.github.com/hatred/1cc6db05d0ca51397886 > > > Thanks, > > Anand Mazumdar > >
