mesos-reviews mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Guangya Liu" <gyliu...@gmail.com>
Subject Re: Review Request 41661: Added documentation for API versioning.
Date Tue, 22 Dec 2015 23:55:47 GMT

-----------------------------------------------------------
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
> 
>


Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message