Skip to content

Commit

Permalink
docs(MAINTAINERS): add documentation describing project maintainers
Browse files Browse the repository at this point in the history
  • Loading branch information
carmstrong committed Mar 11, 2015
1 parent 8826c83 commit 407dbd2
Showing 1 changed file with 88 additions and 0 deletions.
88 changes: 88 additions & 0 deletions MAINTAINERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
# Deis Maintainers

This document serves to describe the leadership structure of the Deis project, and list the current
project maintainers.

# What is a maintainer?

(Unabashedly stolen from the [Docker](https://github.com/docker/docker/blob/master/MAINTAINERS) project)

There are different types of maintainers, with different responsibilities, but
all maintainers have 3 things in common:

1. They share responsibility in the project's success.
2. They have made a long-term, recurring time investment to improve the project.
3. They spend that time doing whatever needs to be done, not necessarily what
is the most interesting or fun.

Maintainers are often under-appreciated, because their work is harder to appreciate.
It's easy to appreciate a really cool and technically advanced feature. It's harder
to appreciate the absence of bugs, the slow but steady improvement in stability,
or the reliability of a release process. But those things distinguish a good
project from a great one.

# Deis maintainers

Deis has two groups of maintainers in addition to our beloved Benevolent Dictator for Life.

## BDFL

Deis follows the timeless, highly efficient and totally unfair system known as [Benevolent dictator
for life](http://en.wikipedia.org/wiki/Benevolent_Dictator_for_Life).

Gabriel Monroy ([@gabrtv](https://github.com/gabrtv)), as creator of the Deis project, serves as our
project's BDFL. While the day-to-day project management is carried out by the maintainers, Gabriel
serves as the final arbiter of any disputes and has the final say on project direction.

## Core maintainers

Core maintainers are exceptionally knowledgeable about all areas of Deis. Some maintainers work on Deis
full-time, although this is not a requirement.

The duties of a core maintainer include:
* Classify and respond to GitHub issues and review pull requests
* Help to shape the Deis roadmap and lead efforts to accomplish roadmap milestones
* Participate actively in feature development and bug fixing
* Answer questions and help users in IRC

The current core maintainers of Deis:
* Chris Armstrong - <[email protected]> ([@carmstrong](https://github.com/carmstrong))
* Matt Boersma - <[email protected]> ([@mboersma](https://github.com/mboersma))
* Matthew Fisher - <[email protected]> ([@bacongobbler](https://github.com/bacongobbler))

No pull requests can be merged until at least one core maintainer signs off with a [Code LGTM](http://docs.deis.io/en/latest/contributing/standards/#merge-approval). The other LGTM can come from either a core maintainer
or contributing maintainer.

## Contributing maintainers

Contributing maintainers are exceptionally knowledgeable about some but not necessarily all areas
of Deis, and are often selected due to specific domain knowledge that complements the project (but
a willingness to continually contribute to the project is most important!). Often,
core maintainers will ask a contributing maintainer to weigh in on issues, pull requests, or
conversations where the contributing maintainer is knowledgeable.

The duties of a contributing maintainer are very similar to those of a core maintainer, but they are limited to areas of the Deis project where the contributing maintainer is knowledgeable.

The current contributing maintainers of Deis:
* Sivaram Mothiki - <[email protected]> ([@smothiki](https://github.com/smothiki))

## Becoming a maintainer

The Deis project wouldn't be where it is today without its community. Many of the project's
community members embody the spirit of maintainership, and have contributed substantially to
the project.

The contributing maintainers group was created in part so that exceptional members of the community
who have an interest in the continued success of the project have the opportunity to join the
core maintainers in guiding the future of Deis.

Generally, potential contributing maintainers are selected by the Deis core maintainers based in
part on the following criteria:
* Sustained contributions to the project over a period of time (usually months)
* A willingness to help Deis users on GitHub and in IRC
* A friendly attitude :)

The Deis core maintainers must unanimously agree before inviting a community member to join as a
contributing maintainer, although in many cases the candidate has already been acting in the
capacity of a contributing maintainer for some time, and has been consulted on issues, pull requests,
etc.

0 comments on commit 407dbd2

Please sign in to comment.