This guide explains how decision-making works in Apache communities, especially within Incubator podlings. Consensus is the foundation of governance at the ASF, formal votes are only one way of measuring it.
Understanding when and how to use discussion, lazy consensus, and formal votes helps ensure decisions are transparent, inclusive, and aligned with The Apache Way.
In practice:
Every discussion starts by seeking broad agreement rather than counting votes. Encourage participation and document differing views. Use a vote when consensus isn’t clear, or when formally recording the community’s agreement aids transparency and traceability.
The most common ASF decision pattern.
A proposal is posted; if no one objects within a stated time (typically 72 hours), it is considered approved.
Example:
“I’ll merge this pull request in 72 hours unless anyone objects.”
When objections arise, discuss until all major concerns are addressed. Adjust the proposal to accommodate feedback where possible.
Formal votes are used when ASF policy or legal requirements demand a clear decision.
Common examples:
Votes are held on the appropriate mailing list (dev@ for community matters, private@ for personnel).
Each binding voter (PPMC or IPMC member, depending on the vote) replies with:
+1 Approve
0 Abstain
-1 Disapprove (with explanation)
PPMC votes are binding for adding new committers and PPMC members.
Release votes follow a two-stage process:
dev@ list, where the PPMC reviews and votes on the release.Graduation votes are also held on general@ and require IPMC binding approval.
Community members can always vote or comment to share their opinions and help build consensus, even if their votes are non-binding.
A -1 vote signals concern that should be discussed and resolved, it’s part of dialogue, not a rejection of people or effort.
The Incubator PMC (IPMC) provides oversight on behalf of the ASF Board while a project is in incubation.
IPMC votes — for example, on releases and graduations — are how this oversight is exercised.
Once a project graduates, those decisions move entirely to its own PMC.
| Type of Decision | Who Votes | Binding? | Where |
|---|---|---|---|
| Routine actions | Anyone | Informal | dev@ |
| Adding committers | PPMC members | Yes (PPMC) | private@ |
| Adding PPMC members | PPMC members | Yes (PPMC) | private@ |
| Releases | PPMC and Mentors / IPMC | Yes (IPMC) | dev@ → general@ |
| Graduation | PPMC → IPMC | Yes (IPMC) | general@ |
Releases in the Incubator use a two-stage voting process:
dev@ list to confirm community consensus.general@incubator.apache.org list to approve the release for publication.Mentors should ensure both votes are clearly recorded, include accurate tallies of binding and non-binding votes, and link the dev@ result when starting the IPMC vote thread for transparency.
Non-binding votes (from contributors, committers, and community members) do not carry legal weight but are valuable indicators of engagement and shared ownership.
They demonstrate community participation and help mentors and the IPMC assess whether a podling’s community is active, healthy, and inclusive.
When closing a vote, post a clear summary listing binding and non-binding votes separately.
Include a short outcome statement (e.g., “The vote passed with 3 binding +1s and no objections”), and link to the discussion thread.
This helps future reviewers, mentors, and auditors easily locate the record of decisions.
Only votes made on official ASF-managed mailing lists are recognized as valid.
Off-list or private votes should never happen — all decision-making must be visible to the community.
ASF decision-making is based on consensus, not simple majority.
The goal is to reach broad agreement and address concerns through discussion.
Votes help confirm that consensus, but they do not replace dialogue and understanding.
Standard ASF and Incubator practice allows at least 72 hours for most votes.
This ensures all participants across time zones have the opportunity to review and respond.
Longer periods are encouraged for complex or contentious proposals.
Mentors help ensure podlings:
Escalation and IPMC Support
If consensus breaks down or a podling is unsure about process (for example, during release or personnel votes), mentors may request guidance from the IPMC on general@incubator.apache.org.
The IPMC’s role is advisory and oversight-based — helping the community learn ASF practices, not deciding on its behalf.
Mentors as Bridges
Mentors act as bridges between the podling and the broader ASF community, helping translate ASF expectations and ensuring that podling practices remain aligned with Foundation policies throughout incubation.
Mentors should model good practice — explaining reasoning, clarifying ASF norms, and gently guiding PPMC discussions when votes are misused or rushed.
| Pattern | Why It’s a Problem | Better Approach |
|---|---|---|
| Private decisions in chats | Excludes community and violates transparency | Move all decisions to dev@ |
| Corporate block voting | Undermines meritocracy | Encourage individual voices |
| Silence misread as agreement | May hide confusion or apathy | Actively invite feedback |
| Vote without discussion | Misses perspectives | Start with open dialogue |
Ignoring -1 votes | Breaks trust | Address and resolve concerns before proceeding |
Demonstrating effective consensus building is part of showing community maturity.
The IPMC and Board look for evidence that the podling can govern itself independently.
Graduation indicators: