> On Jan. 7, 2016, 11:55 p.m., Neil Conway wrote: > > docs/quota.md, line 61 > > <https://reviews.apache.org/r/42040/diff/1/?file=1186512#file1186512line61> > > > > These kinds of implementation details belong at the bottom of the > > document, I think -- it is more important to tell the user/operator how to > > define quota before we worry about allocator details. > > > > We could also remove a lot of this information -- the specific steps we > > take to implement a set/remove quota request are not an important thing to > > document (and might change over time). > > Alexander Rukletsov wrote: > Our intention was *not* to provide implementation details, but to mention > some of those, which are important and affect cluster behaviour. There are 3 > things: capacity heuristic, rescinding offers, allocator logic (quota first, > fair share second). I do think we should explain operators how these things > work so that they don't break their clusters. > > However, if the section feels like an "implementation details" section, > we didn't achieve our goal. The reason we decided to briefly mention other > stages is in order not to be misleading and leave an impression, that there > is nothing else. > > Do you think leaving only these 3 sections and adding a sentence that > those are most important stages in quota processing is a good compromise? > > Neil Conway wrote: > I think we could improve things in two ways: > > 1. Move the "How does it work?" section to the end of the document. > Although this is useful material, it is fairly advanced; a lot of users will > want to just know how to configure/examine quota. > 2. Remove some of the implementation details. For example, the fact that > we authenticate, parse, validate, and authorize a quota request is not > important for the information we want to convey to operators about how quotas > behave.
IMO all steps (except inform allocator, which I agree can be dropped) have potential implication for the operator as he might receive error relating to each stage or it influences the behavior of the cluster (failover & rescinding). - Joerg ----------------------------------------------------------- This is an automatically generated e-mail. To reply, visit: https://reviews.apache.org/r/42040/#review113358 ----------------------------------------------------------- On Jan. 8, 2016, 10:26 a.m., Joerg Schad wrote: > > ----------------------------------------------------------- > This is an automatically generated e-mail. To reply, visit: > https://reviews.apache.org/r/42040/ > ----------------------------------------------------------- > > (Updated Jan. 8, 2016, 10:26 a.m.) > > > Review request for mesos, Alexander Rukletsov, Bernd Mathiske, Joris Van > Remoortere, and Neil Conway. > > > Bugs: MESOS-3877 > https://issues.apache.org/jira/browse/MESOS-3877 > > > Repository: mesos > > > Description > ------- > > Added Quota Operator Documentation. > > > Diffs > ----- > > docs/home.md 6f0f4b9cb9d0da1f9960ebe7f36ce186c1317535 > docs/quota.md PRE-CREATION > > Diff: https://reviews.apache.org/r/42040/diff/ > > > Testing > ------- > > Rendered version: https://gist.github.com/joerg84/a2c32e25d91e33045b56 > > > Thanks, > > Joerg Schad > >
