Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
executable file 868 lines (786 sloc) 29.9 KB
# THIS FILE IS AUTOGENERATED; SEE "./maintainercollector"!
# Docker projects maintainers file
# This file describes who runs the Docker project and how.
# This is a living document - if you see something out of date or missing,
# speak up!
# It is structured to be consumable by both humans and programs.
# To extract its contents programmatically, use any TOML-compliant
# parser.
title = "What is a maintainer?"
text = """
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.
title = "How are maintainers added?"
text = """
Maintainers are first and foremost contributors that have shown they are
committed to the long term success of a project. Contributors wanting to
become maintainers are expected to be deeply involved in contributing code,
pull request review, and triage of issues in the project for more than three
Just contributing does not make you a maintainer, it is about building trust
with the current maintainers of the project and being a person that they can
depend on and trust to make decisions in the best interest of the project.
Maintainers are assigned per project (repository). Being a maintainer in
one project does not automatically make you a maintainer in other projects.
Periodically, the existing maintainers curate a list of contributors that have
shown regular activity on the project over the prior months. From this
list, maintainer candidates are selected and proposed on the maintainers
mailing list.
After a candidate has been announced on the maintainers mailing list, the
existing maintainers are given five business days to discuss the candidate,
raise objections and cast their vote. Candidates must be approved by the BDFL
and at least 66% of the current maintainers by adding their vote on the mailing
list. Only maintainers of the repository that the candidate is proposed for are
allowed to vote. The BDFL's vote is mandatory.
If a candidate is approved, a maintainer will contact the candidate to
invite the candidate to open a pull request that adds the contributor to
the MAINTAINERS file. The candidate becomes a maintainer once the pull
request is merged.
title = "Stepping down policy"
text = """
Life priorities, interests, and passions can change. If you're a maintainer but
feel you must remove yourself from the list, inform other maintainers that you
intend to step down, and if possible, help find someone to pick up your work.
At the very least, ensure your work can be continued where you left off.
After you've informed other maintainers, create a pull request to remove
yourself from the MAINTAINERS file.
title = "Removal of inactive maintainers"
text = """
Similar to the procedure for adding new maintainers, existing maintainers can
be removed from the list if they do not show significant activity on the
project. Periodically, the maintainers review the list of maintainers and their
activity over the last three months.
If a maintainer has shown insufficient activity over this period, a neutral
person will contact the maintainer to ask if they want to continue being
a maintainer. If the maintainer decides to step down as a maintainer, they
open a pull request to be removed from the MAINTAINERS file.
If the maintainer wants to remain a maintainer, but is unable to perform the
required duties they can be removed with a vote by the BDFL and at least 66% of
the current maintainers. The BDFL's vote is mandatory. An e-mail is sent to the
mailing list, inviting maintainers of the project to vote. The voting period is
five business days. Issues related to a maintainer's performance should be
discussed with them among the other maintainers so that they are not surprised
by a pull request removing them.
title = "Alumni"
text = """
Projects can opt to keep a list of former maintainers in the MAINTAINERS file.
Instead of removing a maintainer from the file when they step down, the maintainer
is moved to the alumni list (`[Org.Alumni]`). People on this list have
no official capacity in the project, it's a way to say "thank you" for the
work they have done for the project.
title = "The Benevolent dictator for life (BDFL)"
text = """
Docker follows the timeless, highly efficient and totally unfair system
known as [Benevolent dictator for
life](, with
yours truly, Solomon Hykes, in the role of BDFL. This means that all
decisions are made, by default, by Solomon. Since making every decision
myself would be highly un-scalable, in practice decisions are spread
across multiple maintainers.
Ideally, the BDFL role is like the Queen of England: awesome crown, but not
an actual operational role day-to-day. The real job of a BDFL is to NEVER GO AWAY.
Every other rule can change, perhaps drastically so, but the BDFL will always
be there, preserving the philosophy and principles of the project, and keeping
ultimate authority over its fate. This gives us great flexibility in experimenting
with various governance models, knowing that we can always press the "reset" button
without fear of fragmentation or deadlock. See the US congress for a counter-example.
BDFL daily routine:
* Is the project governance stuck in a deadlock or irreversibly fragmented?
* If yes: refactor the project governance
* Are there issues or conflicts escalated by core?
* If yes: resolve them
* Go back to polishing that crown.
title = "How are decisions made?"
text = """
Docker is an open-source project with an open design philosophy. This
means that the repository is the source of truth for EVERY aspect of the
project, including its philosophy, design, road map, and APIs. *If it's
part of the project, it's in the repo. If it's in the repo, it's part of
the project.*
As a result, all decisions can be expressed as changes to the
repository. An implementation change is a change to the source code. An
API change is a change to the API specification. A philosophy change is
a change to the philosophy manifesto, and so on.
All decisions affecting Docker, big and small, follow the same 3 steps:
* Step 1: Open a pull request. Anyone can do this.
* Step 2: Discuss the pull request. Anyone can do this.
* Step 3: Merge or refuse the pull request. Who does this depends on the nature
of the pull request and which areas of the project it affects. See *review flow*
for details.
Because Docker is such a large and active project, it's important for everyone to know
who is responsible for deciding what. That is determined by a precise set of rules.
* For every *decision* in the project, the rules should designate, in a deterministic way,
who should *decide*.
* For every *problem* in the project, the rules should designate, in a deterministic way,
who should be responsible for *fixing* it.
* For every *question* in the project, the rules should designate, in a deterministic way,
who should be expected to have the *answer*.
title = "Review flow"
text = """
Pull requests should be processed according to the following flow:
* For each subsystem affected by the change, the maintainers of the subsystem must approve or refuse it.
It is the responsibility of the subsystem maintainers to process patches affecting them in a timely
* If the change affects areas of the code which are not part of a subsystem,
or if subsystem maintainers are unable to reach a timely decision, it must be approved by
the core maintainers.
* If the change affects the UI or public APIs, or if it represents a major change in architecture,
the architects must approve or refuse it.
* If the change affects the operations of the project, it must be approved or rejected by
the relevant operators.
* If the change affects the governance, philosophy, goals or principles of the project,
it must be approved by BDFL.
title = "Helping contributors with the DCO"
text = """
The [DCO or `Sign your work`](
requirement is not intended as a roadblock or speed bump.
Some Docker contributors are not as familiar with `git`, or have used a web based
editor, and thus asking them to `git commit --amend -s` is not the best way forward.
In this case, maintainers can update the commits based on clause (c) of the DCO. The
most trivial way for a contributor to allow the maintainer to do this, is to add
a DCO signature in a pull requests's comment, or a maintainer can simply note that
the change is sufficiently trivial that it does not substantially change the existing
contribution - i.e., a spelling change.
When you add someone's DCO, please also add your own to keep a log.
[Rules."no direct push"]
title = "I'm a maintainer. Should I make pull requests too?"
text = """
Yes. Nobody should ever push to master directly. All changes should be
made through a pull request.
title = "How is this process changed?"
text = "Just like everything else: by making a pull request :)"
# Current project roles
person = "shykes"
[Roles."Chief Architect"]
person = "shykes"
text = """
The chief architect is responsible for the overall integrity of the technical architecture
across all subsystems, and the consistency of APIs and UI.
Changes to UI, public APIs and overall architecture (for example a plugin system) must
be approved by the chief architect.
[Roles."Chief Maintainer"]
person = "crosbymichael"
text = """
The chief maintainer is responsible for all aspects of quality for the project including
code reviews, usability, stability, security, performance, etc.
The most important function of the chief maintainer is to lead by example. On the first
day of a new maintainer, the best advice should be "follow the C.M.'s example and you'll
be fine".
[Roles."Community Manager"]
people = ["thajeztah", "vcoisne"]
text = """
The community manager is responsible for serving the project community, including users,
contributors and partners. This involves:
- facilitating communication between maintainers, contributors and users
- organizing contributor and maintainer events
- helping new contributors get involved
- anything the project community needs to be successful
The community manager is a point of contact for any contributor who has questions, concerns
or feedback about project operations.
People = ["alexellis", "amitshukla", "andrewhsu", "anonymuse", "anshulpundir", "chanwit", "chungers", "fntlnz", "gianarb", "programmerq", "rheinwein", "ripcurld", "thajeztah"]
[Org."Docs maintainers"]
People = ["misty", "thajeztah"]
People = ["ehazlett", "tianon"]
People = ["aaronlehmann", "albers", "cpuguy83", "dnephin", "justincormack", "silvin-lubecki", "stevvooe", "thajeztah", "tibor", "tonistiigi", "vdemeester", "vieux"]
People = ["mefyl", "mnottale", "shin-"]
People = ["abhi", "akihirosuda", "crosbymichael", "dchen1107", "dmcgowan", "dqminh", "estesp", "hqhq", "jhowardmsft", "mikebrow", "mlaventure", "random-liu", "stevvooe", "yujuhong"]
People = ["samoht", "talex5"]
People = ["aaronlehmann", "dmcgowan", "dmp42", "richardscothern", "shykes", "stevvooe"]
People = ["diogomonica", "konstruktoid"]
People = ["coolljt0725", "cpuguy83", "crosbymichael", "dnephin", "duglin", "estesp", "jhowardmsft", "mavenugo", "mhbauer", "n4ss", "runcom", "stevvooe", "thajeztah", "tianon", "tibor", "tonistiigi", "unclejack", "vdemeester", "vieux"]
People = ["shin-"]
People = ["aduermael", "dave-tucker", "gdevillele"]
People = ["aaronlehmann", "calavera", "coolljt0725", "cpuguy83", "crosbymichael", "dnephin", "dongluochen", "duglin", "estesp", "icecrime", "jhowardmsft", "lk4d4", "mavenugo", "mhbauer", "runcom", "stevvooe", "thajeztah", "tianon", "tibor", "tonistiigi", "unclejack", "vdemeester", "vieux"]
People = ["akihirosuda", "dnephin", "thajeztah", "vdemeester"]
People = ["aaronlehmann", "aluzzardi", "lk4d4", "stevvooe"]
People = ["diogomonica", "nathanmccauley", "stevvooe"]
People = ["aduermael", "djs55", "frenchben", "justincormack", "stevvooe"]
People = ["calavera", "dave-tucker", "runcom"]
People = ["akihirosuda", "dnephin", "thajeztah", "vdemeester"]
People = ["avsm", "djs55", "dsheets", "gdevillele", "ijc", "justincormack", "magnuss", "rn", "samoht"]
People = ["chungers", "frenchben", "kaufers", "ndegory", "thebsdbox", "yujioshima"]
People = ["elesant", "frenchben", "jeffdm", "mchiang0610"]
People = ["aluzzardi"]
People = ["calavera", "icecrime", "jessfraz", "thajeztah", "vdemeester"]
People = ["dmcgowan", "shykes"]
People = ["aanand", "aduermael", "dnephin", "gdevillele", "ibuildthecloud", "joshwget", "vdemeester"]
People = ["aluzzardi", "sanimej", "vieux"]
People = ["abhi", "aboch", "chenchun", "ctelfer", "fcrisciani", "mavenugo"]
People = ["deitch", "ijc", "justincormack", "riyazdf", "rn"]
People = ["dgageot", "jeanlaurent", "shin-"]
People = ["mbentley"]
People = ["aaronlehmann", "akihirosuda", "anusha", "coolljt0725", "cpuguy83", "crosbymichael", "dnephin", "duglin", "estesp", "jhowardmsft", "johnstep", "justincormack", "mhbauer", "mlaventure", "runcom", "stevvooe", "thajeztah", "tianon", "tibor", "tonistiigi", "unclejack", "vdemeester", "vieux", "yongtang"]
People = ["cyli", "diogomonica", "ecordell", "endophage", "hukeping", "nathanmccauley", "riyazdf"]
People = ["dmcgowan"]
People = ["allencloud", "aluzzardi", "chanwit", "dani-docker", "dongluochen", "jimmyxian", "mhbauer", "nishanttotla", "vieux"]
People = ["amitshukla", "samalba"]
People = ["aaronlehmann", "aluzzardi", "amitshukla", "anshulpundir", "cyli", "diogomonica", "dongluochen", "dperny", "lk4d4", "nishanttotla", "stevvooe", "tonistiigi", "vieux", "yongtang"]
People = ["jeffdm", "lisean106", "mchiang0610"]
People = ["tonistiigi"]
People = ["avsm", "djs55", "samoht"]
Name = "Aanand Prasad"
Email = ""
GitHub = "aanand"
Name = "Aaron Lehmann"
Email = ""
GitHub = "aaronlehmann"
Name = "Abhinandan Prativadi Bayankaram"
Email = ""
GitHub = "abhi"
Name = "Alessandro Boch"
Email = ""
GitHub = "aboch"
Name = "Adrien Duermael"
Email = ""
GitHub = "aduermael"
Name = "Akihiro Suda"
Email = ""
GitHub = "AkihiroSuda"
Name = "Harald Albers"
Email = ""
GitHub = "albers"
Name = "Alex Ellis"
Email = ""
GitHub = "alexellis"
Name = "Allen Sun"
Email = ""
GitHub = "allencloud"
Name = "Andrea Luzzardi"
Email = ""
GitHub = "aluzzardi"
Name = "Amit Shukla"
Email = ""
GitHub = "amitshukla"
Name = "Andrew Hsu"
Email = ""
GitHub = "andrewhsu"
Name = "Jesse White"
Email = ""
GitHub = "anonymuse"
Name = "Anshul Pundir"
Email = ""
GitHub = "anshulpundir"
Name = "Anusha Ragunathan"
Email = ""
GitHub = "anusha-ragunathan"
Name = "Anil Madhavapeddy"
Email = ""
GitHub = "avsm"
Name = "Ben Firshman"
Email = ""
GitHub = "bfirsh"
Name = "David Calavera"
Email = ""
GitHub = "calavera"
Name = "Chanwit Kaewkasi"
Email = ""
GitHub = "chanwit"
Name = "Chun Chen"
Email = ""
GitHub = "chenchun"
Name = "David Chung"
Email = ""
GitHub = "chungers"
Name = "Lei Jitang"
Email = ""
GitHub = "coolljt0725"
Name = "Brian Goff"
Email = ""
GitHub = "cpuguy83"
Name = "Michael Crosby"
Email = ""
GitHub = "crosbymichael"
Name = "Christopher Telfer"
Email = ""
GitHub = "ctelfer"
Name = "Ying Li"
Email = ""
GitHub = "cyli"
Name = "Dani Louca"
Email = ""
GitHub = "dani-docker"
Name = "Dave Tucker"
Email = ""
GitHub = "dave-tucker"
Name = "Dawn Chen"
Email = ""
GitHub = "dchen1107"
Name = "Avi Deitcher"
Email = ""
GitHub = "deitch"
Name = "David Gageot"
Email = ""
GitHub = "dgageot"
Name = "Diogo Monica"
Email = ""
GitHub = "diogomonica"
Name = "David Scott"
Email = ""
GitHub = "djs55"
Name = "Derek McGowan"
Email = ""
GitHub = "dmcgowan"
Name = "Olivier Gambier"
Email = ""
GitHub = "dmp42"
Name = "Daniel Nephin"
Email = ""
GitHub = "dnephin"
Name = "Dongluo Chen"
Email = ""
GitHub = "dongluochen"
Name = "Drew Erny"
Email = ""
GitHub = "dperny"
Name = "Daniel, Dao Quang Minh"
Email = ""
GitHub = "dqminh"
Name = "David Sheets"
Email = ""
GitHub = "dsheets"
Name = "Doug Davis"
Email = ""
GitHub = "duglin"
Name = "Evan Cordell"
Email = ""
GitHub = "ecordell"
Name = "Evan Hazlett"
Email = ""
GitHub = "ehazlett"
Name = "Sean Li"
Email = ""
GitHub = "elesant"
Name = "David Lawrence"
Email = ""
GitHub = "endophage"
Name = "Erik Hollensbe"
Email = ""
GitHub = "erikh"
Name = "Phil Estes"
Email = ""
GitHub = "estesp"
Name = "Flavio Crisciani"
Email = ""
GitHub = "fcrisciani"
Name = "Lorenzo Fontana"
Email = ""
GitHub = "fntlnz"
Name = "Ben French"
Email = ""
GitHub = "FrenchBen"
Name = "Gaetan de Villele"
Email = ""
GitHub = "gdevillele"
Name = "Gianluca Arbezzano"
Email = ""
GitHub = "gianarb"
Name = "Qiang Huang"
Email = ""
GitHub = "hqhq"
Name = "Hu Keping"
Email = ""
GitHub = "hukeping"
Name = "Darren Shepherd"
Email = ""
GitHub = "ibuildthecloud"
Name = "Arnaud Porterie"
Email = ""
GitHub = "icecrime"
Name = "Ian Campbell"
Email = ""
GitHub = "ijc"
Name = "James Turnbull"
Email = ""
GitHub = "jamtur01"
Name = "Jean-Laurent de Morlhon"
Email = ""
GitHub = "jeanlaurent"
Name = "Jeff Morgan"
Email = ""
GitHub = "jeffdm"
Name = "Jessie Frazelle"
Email = ""
GitHub = "jessfraz"
Name = "Jessica Valarezo"
Email = ""
GitHub = "jessvalarezo"
Name = "John Howard"
Email = ""
GitHub = "jhowardmsft"
Name = "Xian Chaobo"
Email = ""
GitHub = "jimmyxian"
Name = "John Stephens"
Email = ""
GitHub = "johnstep"
Name = "Josh Curl"
Email = ""
GitHub = "joshwget"
Name = "Justin Cormack"
Email = ""
GitHub = "justincormack"
Name = "Steven Kaufer"
Email = ""
GitHub = "kaufers"
Name = "Thomas Sjögren"
Email = ""
GitHub = "konstruktoid"
Name = "Sean Li"
Email = ""
GitHub = "lisean106"
Name = "Alexander Morozov"
Email = ""
GitHub = "lk4d4"
Name = "Magnus Skjegstad"
Email = ""
GitHub = "MagnusS"
Name = "Madhu Venugopal"
Email = ""
GitHub = "mavenugo"
Name = "Matt Bentley"
Email = ""
GitHub = "mbentley"
Name = "Michael Chiang"
Email = ""
GitHub = "mchiang0610"
Name = "Quentin Hocquet"
Email = ""
GitHub = "mefyl"
Name = "Morgan Bauer"
Email = ""
GitHub = "mhbauer"
Name = "Yanqiang Miao"
Email = ""
GitHub = "miaoyq"
Name = "Mike Brown"
Email = ""
GitHub = "mikebrow"
Name = "Misty Stanley-Jones"
Email = ""
GitHub = "mistyhacks"
Name = "Kenfe-Mickaël Laventure"
Email = ""
GitHub = "mlaventure"
Name = "Matthieu Nottale"
Email = ""
GitHub = "mnottale"
Name = "Mazz Mosley"
Email = ""
GitHub = "mnowster"
Name = "Mary Anthony"
Email = ""
GitHub = "moxiegirl"
Name = "Maxime Petazzoni"
Email = ""
GitHub = "mpetazzoni"
Name = "Jana Radhakrishnan"
Email = ""
GitHub = "mrjana"
Name = "Nassim Eddequiouaq"
Email = ""
GitHub = "n4ss"
Name = "Nathan McCauley"
Email = ""
GitHub = "nathanmccauley"
Name = "Nicolas Degory"
Email = ""
GitHub = "ndegory"
Name = "Nishant Totla"
Email = ""
GitHub = "nishanttotla"
Name = "Jeff Anderson"
Email = ""
GitHub = "programmerq"
Name = "Lantao Liu"
Email = ""
GitHub = "Random-Liu"
Name = "Laura Frank"
Email = ""
GitHub = "rheinwein"
Name = "Richard Scothern"
Email = ""
GitHub = "richardscothern"
Name = "Boaz Shuster"
Email = ""
GitHub = "ripcurld"
Name = "Riyaz Faizullabhoy"
Email = ""
GitHub = "riyazdf"
Name = "Rolf Neugebauer"
Email = ""
GitHub = "rn"
Name = "Antonio Murdaca"
Email = ""
GitHub = "runcom"
Name = "Sam Alba"
Email = ""
GitHub = "samalba"
Name = "Thomas Gazagnaire"
Email = ""
GitHub = "samoht"
Name = "Santhosh Manohar"
Email = ""
GitHub = "sanimej"
Name = "Joffrey F"
Email = ""
GitHub = "shin-"
Name = "Solomon Hykes"
Email = ""
GitHub = "shykes"
Name = "Silvin Lubecki"
Email = ""
GitHub = "silvin-lubecki"
Name = "Stephen Day"
Email = ""
GitHub = "stevvooe"
Name = "Sven Dowideit"
Email = ""
GitHub = "SvenDowideit"
Name = "Thomas Leonard"
Email = ""
GitHub = "talex5"
Name = "Sebastiaan van Stijn"
Email = ""
GitHub = "thaJeztah"
Name = "Dan Finneran"
Email = ""
GitHub = "thebsdbox"
Name = "Tianon Gravi"
Email = ""
GitHub = "tianon"
Name = "Tibor Vass"
Email = ""
GitHub = "tiborvass"
Name = "Tõnis Tiigi"
Email = ""
GitHub = "tonistiigi"
Name = "Cristian Staretu"
Email = ""
GitHub = "unclejack"
Name = "Vincent Batts"
Email = ""
GitHub = "vbatts"
Name = "Vincent Demeester"
Email = ""
GitHub = "vdemeester"
Name = "Victor Vieux"
Email = ""
GitHub = "vieux"
Name = "Vishnu Kannan"
Email = ""
GitHub = "vishh"
Name = "Xuean Yan"
Email = ""
GitHub = "yanxuean"
Name = "Yong Tang"
Email = ""
GitHub = "yongtang"
Name = "Yuji Oshima"
Email = ""
GitHub = "YujiOshima"
Name = "Yu-Ju Hong"
Email = ""
GitHub = "yujuhong"