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.


1. Principles of Consensus Building

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.


2. Forms of Consensus

2.1 Lazy Consensus

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.”


2.2 Consensus After Discussion

When objections arise, discuss until all major concerns are addressed. Adjust the proposal to accommodate feedback where possible.


2.3 Formal Votes

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:


IPMC Oversight

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.


3. Who Can Vote and When

Type of DecisionWho VotesBinding?Where
Routine actionsAnyoneInformaldev@
Adding committersPPMC membersYes (PPMC)private@
Adding PPMC membersPPMC membersYes (PPMC)private@
ReleasesPPMC and Mentors / IPMCYes (IPMC)dev@general@
GraduationPPMC → IPMCYes (IPMC)general@

Releases in the Incubator use a two-stage voting process:

  1. The PPMC conducts the initial vote on the podling’s dev@ list to confirm community consensus.
  2. The IPMC holds the binding vote on the 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.


4. Best Practices for Healthy Consensus


5. Additional Notes and Tips

Non-Binding Votes

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.

Recording Vote Results

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.

Consensus vs. Majority Rule

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.

Typical Vote Duration

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.


6. Mentor Role in Consensus Building

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.


7. Common Anti-Patterns

PatternWhy It’s a ProblemBetter Approach
Private decisions in chatsExcludes community and violates transparencyMove all decisions to dev@
Corporate block votingUndermines meritocracyEncourage individual voices
Silence misread as agreementMay hide confusion or apathyActively invite feedback
Vote without discussionMisses perspectivesStart with open dialogue
Ignoring -1 votesBreaks trustAddress and resolve concerns before proceeding

8. Tying Consensus to Graduation

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:


9. Related Resources