Modified: mesos/site/source/documentation/latest.html.md URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest.html.md?rev=1680431&r1=1680430&r2=1680431&view=diff ============================================================================== --- mesos/site/source/documentation/latest.html.md (original) +++ mesos/site/source/documentation/latest.html.md Wed May 20 00:04:22 2015 @@ -45,6 +45,7 @@ layout: documentation * [Submitting a Patch](/documentation/latest/submitting-a-patch/) for getting started with ReviewBoard, and our tooling around it. * [Effective Code Reviewing](/documentation/latest/effective-code-reviewing/) guidelines, tips, and learnings for how to do effective code reviews. * [Committing](/documentation/latest/committing/) guidelines for committing changes. +* [Committers and Maintainers](/documentation/latest/committers/) a listing of project committers and component maintainers; useful when seeking feedback. * [C++ Style Guide](/documentation/latest/mesos-c++-style-guide/) * [Development Roadmap](/documentation/latest/mesos-roadmap/) * [Release Guide](/documentation/latest/release-guide/)
Added: mesos/site/source/documentation/latest/committers.md URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/committers.md?rev=1680431&view=auto ============================================================================== --- mesos/site/source/documentation/latest/committers.md (added) +++ mesos/site/source/documentation/latest/committers.md Wed May 20 00:04:22 2015 @@ -0,0 +1,300 @@ +--- +layout: documentation +--- + +# Committers + +## Current Committers + +We'd like to thank the following committers to the Apache Mesos project who have helped get the project to where it is today. Committers are voted on by members of the Mesos PMC. This list might be stale, the canonical list is located on [Apache's website](http://people.apache.org/committers-by-project.html#mesos). + +<table class="table table-hover table-condensed"> + <thead> + <tr> + <th>Timezone GMT</th> + <th>Full Name</th> + <th>Company/Organization</th> + <th>IRC Handle</th> + <th>Email Address</th> + </tr> + </thead> + <tbody> + <tr> + <td>-8</td> + <td>Ross Allen</td> + <td></td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Adam B</td> + <td>Mesosphere</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Tim Chen</td> + <td>Mesosphere</td> + <td>tnachen</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Ian Downes</td> + <td>Twitter</td> + <td>idownes</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Ali Ghodsi</td> + <td>UC Berkeley</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Dominic Hamon</td> + <td></td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Benjamin Hindman</td> + <td>Mesosphere</td> + <td>_benh_</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Ian Holsman</td> + <td></td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Vinod Kone</td> + <td>Twitter</td> + <td>vinodkone</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Andy Konwinski</td> + <td>UC Berkeley</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Dave Lester</td> + <td>Twitter</td> + <td>dlester</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Benjamin Mahler</td> + <td>Twitter</td> + <td>bmahler</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Thomas Marshall</td> + <td>Carnegie Mellon University</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Brenden Matthews</td> + <td>Mesosphere</td> + <td>brenden_</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Chris Mattmann</td> + <td>NASA JPL</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Brian McCallister</td> + <td>Groupon</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Niklas Quarfot Nielsen</td> + <td>Mesosphere</td> + <td>niq_</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Charles Reiss</td> + <td>UC Berkeley</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-5</td> + <td>Timothy St Clair</td> + <td>Redhat</td> + <td>tstclair</td> + <td>[email protected]</td> + </tr> + <tr> + <td>+2</td> + <td>Till Toenshoff</td> + <td>Mesosphere</td> + <td>tillt</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Thomas White</td> + <td>Cloudera</td> + <td></td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Yan Xu</td> + <td>Twitter</td> + <td>xujyan</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Jie Yu</td> + <td>Twitter</td> + <td>jieyu</td> + <td>[email protected]</td> + </tr> + <tr> + <td>-8</td> + <td>Matei Alexandru Zaharia</td> + <td>Databricks</td> + <td></td> + <td>[email protected]</td> + </tr> + </tbody> +</table> + +If you're interested in becoming a committer yourself, the best way to do so is by participating in developer discussions and contributing patches to the project. + + +## Component Maintainers + +We currently make no distinction between committers and PMC members. As such, **every committer is responsible for the quality of the entire codebase**. Some components are widely maintained (e.g. build and support tooling, tests, etc), whereas some components are inherently more critical / complex and have committers with increased context, interest, and long-term perspective. + +We aim to have more than one maintainer for each component, in order to ensure that contributors can obtain timely feedback. To avoid information silos, we encourage committers to learn about areas of the code that they are unfamiliar with. + +When sending reviews, it can be valuable to consult the component maintainers, as specified below. Component maintainers do not have any special "ownership" over the code, but merely serve as a resource for obtaining valuable feedback in a timely manner. We trust every committer to use good judgement to determine when to obtain feedback from component maintainers. + +<table class="table table-hover table-condensed"> + <thead> + <tr> + <th>Component</th> + <th>Maintainers (alphabetical)</th> + </tr> + </thead> + <tbody> + <tr> + <td>Master / Slave</td> + <td>Benjamin Hindman, Vinod Kone, Benjamin Mahler, Jie Yu</td> + </tr> + <tr> + <td>Framework API</td> + <td>Benjamin Hindman, Vinod Kone, Benjamin Mahler, Jie Yu</td> + </tr> + <tr> + <td>State Libraries</td> + <td>Benjamin Hindman, Benjamin Mahler</td> + </tr> + <tr> + <td>Replicated Log</td> + <td>Benjamin Hindman, Jie Yu</td> + </tr> + <tr> + <td>ZooKeeper Bindings</td> + <td>Benjamin Hindman, Vinod Kone, Benjamin Mahler, Yan Xu</td> + </tr> + <tr> + <td>Authentication / Authorization</td> + <td>Adam B, Vinod Kone, Till Toenshoff</td> + </tr> + <tr> + <td>Modules / Hooks</td> + <td>Niklas Nielsen, Benjamin Hindman</td> + </tr> + <tr> + <td>CLI</td> + <td><i>maintainers needed</i></td> + </tr> + <tr> + <td>WebUI</td> + <td><i>maintainers needed</i></td> + </tr> + <tr> + <td>Project Website</td> + <td>Dave Lester</td> + </tr> + </tbody> +</table> + + +#### Containerization + +<table class="table table-hover table-condensed"> + <thead> + <tr> + <th>Component</th> + <th>Maintainers (alphabetical)</th> + </tr> + <tbody> + <tr> + <td>Mesos Containerizer</td> + <td>Ian Downes, Jie Yu</td> + </tr> + <tr> + <td>Docker Containerizer</td> + <td>Tim Chen, Benjamin Hindman</td> + </tr> + <tr> + <td>External Containerizer</td> + <td>Till Toenshoff, Benjamin Hindman</td> + </tr> + </tbody> + </thead> +</table> + +#### C++ Libraries + +<table class="table table-hover table-condensed"> + <thead> + <tr> + <th>Component</th> + <th>Maintainers (alphabetical)</th> + </tr> + </thead> + <tbody> + <tr> + <td>Libprocess</td> + <td>Benjamin Hindman, Benjamin Mahler, Jie Yu</td> + </tr> + <tr> + <td>Stout</td> + <td>Benjamin Hindman, Vinod Kone, Benjamin Mahler, Jie Yu</td> + </tr> + </tbody> +</table> Modified: mesos/site/source/documentation/latest/modules.md URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/modules.md?rev=1680431&r1=1680430&r2=1680431&view=diff ============================================================================== --- mesos/site/source/documentation/latest/modules.md (original) +++ mesos/site/source/documentation/latest/modules.md Wed May 20 00:04:22 2015 @@ -143,7 +143,45 @@ could be to support PAM (LDAP, MySQL, NI Similar to Apache Webserver Modules, hooks allows module writers to tie into internal components which may not be suitable to be abstracted entirely behind -modules but rather let's them define actions on so-called hooks. +modules but rather lets them define actions on so-called hooks. + +The available hooks API is defined in mesos/hook.hpp and for each hook defines +the insertion point and available context. An example of this context is the +task information which is passed to masterLaunchTaskHook. + +Some hooks take in an object (e.g. TaskInfo) and return all or part of that +object (e.g. task labels), so that the hook can modify or replace the contents +in-flight. These hooks are referred to as _decorators_. + +In order to enable decorator modules to remove metadata (environment variables +or labels), the effect of the return value for decorator hooks changed in +Mesos 0.23.0. + +The Result<T> return values before and after Mesos 0.23.0 means: + +<table> +<tr> +<th>State</th> +<th>Before (0.22.x)</th> +<th>After (0.23.0+)</th> +</tr> +<tr> +<td>Error</td> +<td>Error is propagated to the call-site</td> +<td>No change</td> +</tr> +<tr> +<td>None</td> +<td>The result of the decorator is not applied</td> +<td>No change</td> +</tr> +<tr> +<td>Some</td> +<td>The result of the decorator is appended</td> +<td>The result of the decorator overwrites the final labels/environment +object</td> +</tr> +</table> To load a hook into Mesos, you need to Modified: mesos/site/source/documentation/latest/powered-by-mesos.md URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/powered-by-mesos.md?rev=1680431&r1=1680430&r2=1680431&view=diff ============================================================================== --- mesos/site/source/documentation/latest/powered-by-mesos.md (original) +++ mesos/site/source/documentation/latest/powered-by-mesos.md Wed May 20 00:04:22 2015 @@ -39,9 +39,10 @@ layout: documentation * [LIFX](http://lifx.co) * [Localsensor](http://www.localsensor.com) * [Magine TV](https://magine.com) +* [Medallia](http://www.medallia.com) +* [MediaCrossing](http://www.mediacrossing.com) * [Medidata Solutions](http://www.mdsol.com) * [meemo](http://www.meemo.io) -* [MediaCrossing](http://www.mediacrossing.com) * [Mesosphere](http://www.mesosphere.io) * [Motus](http://www.motus.com) * [Netflix](http://www.netflix.com) @@ -63,7 +64,7 @@ layout: documentation * [Squarespace](http://squarespace.com) * [TellApart](http://www.tellapart.com/) * [The Factory](http://www.thefactory.com) -* Time Warner Cable +* [Time Warner Cable](http://www.timewarnercable.com) * [Twitter](http://www.twitter.com) * [UCSF](http://www.ucsf.edu) * [UC Berkeley](http://www.berkeley.edu) Modified: mesos/site/source/documentation/latest/upgrades.md URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/upgrades.md?rev=1680431&r1=1680430&r2=1680431&view=diff ============================================================================== --- mesos/site/source/documentation/latest/upgrades.md (original) +++ mesos/site/source/documentation/latest/upgrades.md Wed May 20 00:04:22 2015 @@ -6,6 +6,10 @@ layout: documentation This document serves as a guide for users who wish to upgrade an existing mesos cluster. Some versions require particular upgrade techniques when upgrading a running cluster. Some upgrades will have incompatible changes. +## Upgrading from 0.22.x to 0.23.x + +**NOTE** In order to enable decorator modules to remove metadata (environment variables or labels), we changed the meaning of the return value for decorator hooks in Mesos 0.23.0. Please refer to the modules documentation for more details. + ## Upgrading from 0.21.x to 0.22.x **NOTE** Slave checkpoint flag has been removed as it will be enabled for all Modified: mesos/site/source/layouts/community_section.erb URL: http://svn.apache.org/viewvc/mesos/site/source/layouts/community_section.erb?rev=1680431&r1=1680430&r2=1680431&view=diff ============================================================================== --- mesos/site/source/layouts/community_section.erb (original) +++ mesos/site/source/layouts/community_section.erb Wed May 20 00:04:22 2015 @@ -5,7 +5,7 @@ <li class="list-group-item"><a href="/documentation/latest/submitting-a-patch/">Contribute</a></li> <li class="list-group-item"><a href="/documentation/latest/powered-by-mesos/">Mesos Adopters</a></li> <li class="list-group-item"><a href="/community/user-groups/">User Groups</a></li> - <li class="list-group-item"><a href="/community/committers/">Committers</a></li> + <li class="list-group-item"><a href="/documentation/latest/committers/">Committers</a></li> </li> </div> <div class="col-md-10">
