You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

DRAFT – FOR REVIEW
This content is subject to review by the IPMC and the project community. This material was developed by individuals outside the individual podling communities, who may view events differently than those directly involved. Some content was AI-generated and may contain errors; however, the material has been reviewed and verified by a human for accuracy. It is provided for training and discussion purposes and may contain minor simplifications or adjustments for clarity.

About the ASF Incubator Case Studies

The ASF Incubator Case Studies collect real lessons from podlings across the Incubator. Each case study groups together projects that faced similar challenges and shows how mentors and communities addressed them.

These case studies are intended as reference material for mentors, PPMC members (Podling Project Management Committees), and contributors who want to understand how communities have grown and matured during incubation.

Each case study includes:

  • examples based on verified ASF records and reports
  • common challenges and how they were handled
  • short questions to think about for your own project
  • direct links to ASF policies and guides

You can use these pages to:

  • prepare for mentoring or helping lead a podling
  • compare your project’s progress with earlier examples
  • support six-month reviews or graduation discussions
  • reflect on community growth and transparency

Together, these examples build a shared record of ASF experience in community development.


Purpose and Context

Not every project at Apache is meant to last forever, and that is normal. Graduation, withdrawal, and retirement are all valid outcomes of open development.

Podlings and their mentors sometimes face hard choices when activity slows, goals are met, or the wider ecosystem moves on. The key is to handle each transition openly, respectfully, and with clear communication.

For mentors, this case study shows how to recognise when a community has reached its natural transition point and how to guide it toward closure or renewal. For PPMC members, it highlights how transparent discussion, timely decision-making, and documentation protect the project’s reputation and preserve lessons learned.

This case study draws on five real examples: MXNet, Mesos, Wave, Blur, and Zipkin. Each shows a different kind of transition, from healthy retirement after success to early withdrawal when the ASF model was not the right fit.


Focus Points

  • Recognising when a community has achieved its goals or completed its purpose
  • Handling decline, withdrawal, or retirement transparently and respectfully
  • Documenting decisions and preserving lessons learned for future projects
  • Supporting contributors during transitions so knowledge is not lost

Example Reflection Questions

  • What can mentors do when activity slows after graduation?
  • How can a podling make clear decisions about continuing or withdrawing?
  • How can mentors and the IPMC ensure transitions are communicated openly?
  • How can lessons from retired or withdrawn projects be shared across ASF communities?

Quick Check

Think about your own podling.

  • Is your community still growing, or has it reached a natural plateau as Mesos did before retirement?
  • Are releases and discussions slowing, as they were in MXNet’s final phase?
  • Would the project benefit from refocusing or withdrawing, as Zipkin chose to do?
  • Has the original goal already been achieved, as with Blur and Wave?
  • Are transition plans discussed openly on the dev@ list?

If these questions raise uncertainty, these examples can help you think through healthy ways to close, graduate, or move on.


How to Use These Case Studies

The case studies highlight how past projects managed transitions with openness and respect. You can use them when preparing graduation or withdrawal discussions, supporting reporting cycles, or reflecting on long-term sustainability.

They can help you:

  • recognise signs that a podling has met its goals
  • handle decline or withdrawal transparently
  • frame respectful retirement discussions
  • preserve lessons for the next community
  • reaffirm that all outcomes are valid if handled in The Apache Way

Case Studies

These examples show how different podlings reached the end of their lifecycle, each in its own way.
Their experiences illustrate how to manage transitions openly, maintain respect, and capture what was learned.

MXNet

MXNet entered incubation in January 2017 and graduated in September 2022.
It began at the University of Washington and later gained strong AWS sponsorship.
It delivered multiple ASF-compliant releases and graduated in 2022.
However, most development remained within one company, and contributor diversity did not expand.
As interest waned, the ASF Board and community agreed to retire it in 2023.

Key Point: Graduation does not guarantee sustainability.
What Mentors and PPMCs Can Do: Track post-graduation activity and help ensure leadership and contributions remain diverse.


Mesos

Mesos entered the Incubator in December 2010 and graduated in July 2013
It became critical infrastructure for major companies such as Twitter and Airbnb.
It thrived for years before Kubernetes changed the industry landscape.
As interest declined, the project was retired to the Attic in 2021.

Key Point: Even successful projects can naturally come to a natural conclusion as technology evolves.
What Mentors and PPMCs Can Do: Encourage open discussion about relevance and long-term plans before activity declines.


Wave

Wave entered incubation in December 2010 and retired in January 2018.
Google donated “Wave in a Box” to the ASF in 2010.
Despite enthusiasm, most activity remained among a few original developers.
Few new committers joined, and mailing list activity was minimal.

Key Point: Stalled incubation should lead to honest review and, if needed, closure.
What Mentors and PPMCs Can Do: Support transparent self-assessment and avoid indefinite incubation.


Blur

Blur entered incubation on July 2012 and retired in June 2017.
It was a promising search engine built on Lucene.
However, community growth and releases remained limited.
After repeated IPMC discussions, it was retired.

Key Point: Prolonged inactivity signals the need for respectful closure.
What Mentors and PPMCs Can Do: Encourage early reflection when participation remains low.


Zipkin

Zipkin entered incubation in August 2018 and withdrew in June 2019.
The podling completed Apache Incubator source releases in 2019 and also maintained development activity in the existing OpenZipkin GitHub organization.
The community voted to withdraw from the Incubator in 2019, and development continues successfully outside Apache.

Key Point: Withdrawal can be a positive and transparent outcome.
What Mentors and PPMCs Can Do: Help communities make informed, respectful decisions about whether the ASF model is the right fit.


Across these examples, the shared lesson is that transitions are part of the open-source lifecycle. Handled with transparency and documentation, they strengthen ASF culture by showing that success means learning, not just survival.


Common Patterns Seen in Podlings

PatternWhat It Looks LikeWhy It Matters
Transparent transition discussionsPublic proposals for graduation, withdrawal, or retirementBuilds trust and closure
Declining activity recognised earlyMentors or PPMC initiate honest reflectionPrevents confusion or blame
Respectful retirementCommunity acknowledges achievements and lessonsPreserves dignity and institutional memory
Continued value outside ASFCode or ideas live on elsewhereShows ASF’s support for open ecosystems
Post-graduation follow-upMentors or former IPMC members stay engagedStrengthens continuity and support

These patterns show that the ASF model values how transitions are handled as much as the technical results.


Early Warning Signs

  • Monthly or quarterly reports repeat “no activity” for several cycles
  • Releases or votes consistently delayed without discussion
  • Mentors or key committers disengage quietly
  • Few or no replies to new contributor questions
  • Decisions about direction remain unresolved

Early recognition allows respectful closure before frustration builds.


Reviewing Your Community’s Lifecycle Stage

This table helps mentors and PPMCs discuss project direction and sustainability.
It is a self-review tool, not an ASF checklist.

AreaWhat to AskSigns of Healthy ProgressSigns That Need Attention
SustainabilityIs development continuing at a healthy pace?Regular releases and new contributorsLong periods without visible progress
EngagementAre mentors and PPMC active on lists?Discussion and decisions are visibleOnly occasional or one-person posts
RelevanceDoes the community still meet user needs?New users or adopters appear in discussionsDecline in adoption or industry focus
Decision MakingAre transition options discussed openly?Clear proposals for graduation or closureAvoidance or private conversations
Documentation and HandoffAre lessons being recorded?Public closure summary or retrospectiveUnclear or undocumented ending

Quick Reference: ASF Transition Paths

TransitionDescriptionTypical ApprovalKey ASF Guide
GraduationProject has met community and governance maturity expectations and becomes a Top-Level ProjectVote by the IPMC and BoardPodling Graduation Guide
WithdrawalPodling decides Apache is not the right home and ends incubation voluntarilyVote by the podling and IPMCPodling Retirement Guide
RetirementIPMC and Board conclude that the podling or TLP is inactive or unsustainableIPMC and Board approvalProject Maturity Model

Using These Examples

For Mentors

  • Watch for declining engagement and help the community discuss it early.
  • Encourage open reflection on long-term goals.
  • If withdrawal or retirement becomes likely, guide the podling through the formal ASF process.

For PPMC Members

  • Discuss sustainability during reporting cycles.
  • Do not view retirement as failure, it is a normal part of open development.
  • Preserve lessons for others by documenting what worked and what did not.

Optional reuse

This material can also be used in joint mentor–PPMC discussions or post-retirement retrospectives.


Mentor and PPMC Reference Actions – Managing Lifecycle and Transition

  1. Recognise natural completion
    When goals are met or interest fades, discuss the project’s future openly. (Mesos)

  2. Support transparent decisions
    Keep all transition conversations on dev@ and summarise outcomes for the community. (MXNet)

  3. Document lessons learned
    Publish a short retrospective or closure note to preserve insight. (Wave)

  4. Respect withdrawal choices
    Help communities that decide Apache is not the right fit to leave gracefully. (Zipkin)

  5. Prevent indefinite incubation
    If progress stalls for many months, propose a structured review and possible closure. (Blur)

  6. Encourage post-graduation self-checks
    Follow up six months after graduation to assess diversity and engagement. (MXNet)

  7. Acknowledge achievements
    Celebrate contributions even when retiring; every effort builds the ASF’s shared knowledge. (Mesos, Wave)


Common Mentor and PPMC Pitfalls

  • Avoiding public discussion of decline until it is too late (MXNet)
  • Treating withdrawal as embarrassment rather than choice (Zipkin)
  • Extending incubation indefinitely without progress (Wave, Blur)
  • Failing to document closure outcomes (multiple podlings)
  • Assuming graduation equals permanent success (MXNet, Mesos)

Linking to ASF Oversight

Mentors and PPMCs should reflect lifecycle discussions transparently in podling reports.
The IPMC looks for clear evidence of open decision-making, documented outcomes, and learning from experience.

When preparing for graduation or closure, describe specific community signals rather than general statements.

Examples of Evidence for Podling Reports

  • Public discussion threads proposing graduation or retirement (MXNet, Mesos)
  • Mailing-list consensus on withdrawal decisions (Zipkin)
  • Documented retrospective or closure note (Wave, Blur)
  • Evidence of post-graduation health checks (MXNet)

Relevant ASF Resources

These examples help the IPMC and Board understand transitions clearly and maintain trust in the ASF process.


ASF Cultural Perspective

Open development includes beginnings and endings.
Graduation, withdrawal, and retirement each demonstrate transparency and autonomy.
Communities should be free to conclude their work with dignity and clarity.
Mentors and PPMCs support that by ensuring decisions are visible, records are complete, and achievements are recognised.

Handled this way, every transition strengthens the ASF’s culture of openness and shared learning.
The ASF preserves each project’s public record in perpetuity so future contributors can learn from its history.


A Shared Record of Experience

This case study summarises information from ASF public mailing lists, podling reports, and status pages. It was written from the perspective of observers outside the individual podling communities. Community members may hold differing views on events or timelines, and minor simplifications may be made for clarity or training purposes. It includes historical information drawn from public ASF sources and does not represent the current state of any project mentioned. This content may contain errors or omissions due to AI-generated elements. However, the material has been reviewed and verified by a human for accuracy. These factors do not reduce its value as a reference for understanding patterns of incubation and global collaboration.

  • No labels