DRAFT DRAFT DRAFT

Apache Incubator Mentor

...

Onboarding

...

1. Introduction

1.1 Purpose of This Guide

Welcome to the Apache Incubator mentoring team! Thank you for supporting new projects. This guide orients will orient you to your role, shares share key resources, and helps help you support your podlings confidently and sustainably.

...

2. Welcome from the Incubator PMC

Thank you for wanting to mentor considering mentoring an ASF project! The Incubator PMC values appreciates your commitment dedication to guiding new projects on their journey path to becoming top-level Apache projects. Your role is critical in nurturing healthy communities and helping podlings embrace The Apache Way. We encourage you to reach out on the IPMC general mailing list with any questions or challenges. Together, we build Apache’s future.

...

Mentors must be Incubator PMC members to ensure they understand ASF policies and can participate in formal voting, which is critical to podling development. Any ASF member can ask to become an IPMC member.

New mentors may find it helpful to review the training resources in Section 13 to gain additional confidence before engaging with their first podling.

3.2 Primary Responsibilities

...

• Learn and live The Apache Way—values Way—incorporating values like transparency, meritocracy, and collaboration into their project.
• Follow ASF policies on governance, licensing, and releases.
• Encourage a welcoming, active, and sustainable community.
• Assist in creating clear and thoughtful podling reports.
• Ensure reports are submitted on - time and sign - off on reports.
• Participate in release and graduation votes as part of the Incubator PMC.
• Maintain a presence in mailing lists—answer questions and address issues early.

...

3.4 Your First Steps as Mentor

• Subscribe to the podling’s dev@ and private@ mailing lists.
• Introduce yourself on the dev@ list, explaining your role and how to reach contact you.
• Help the podling complete any outstanding setup tasks.
• Encourage open, transparent discussions on mailing lists.

...

• Using GitHub or private channels instead of mailing lists for to make decisions. Private, off-list decisions reducing reduce transparency.
• Slow adoption of ASF infrastructure, like mailing lists and issue trackers.
• Overdependence on a single company or individual.
• Misuse of ASF trademarks.
• Lack of contributor onboarding or community growth.
• Misunderstanding of ASF governance or The Apache Way.
• Missing or unclear documentation that blocks new contributors.
• Delays or gaps in reporting.
• Use of non-compliant licenses or dependencies.

...

Mentors support and guide, but do not:

• Control or direct podling decisions — - communities govern themselves, following The Apache Way.
• Act as project managers or primary contributors.
• Make unilateral governance or policy decisions.
• Replace the Incubator PMC or ASF officers.
• Handle all conflicts alone — independently - escalate serious issues appropriatelyas needed.
• Keep key discussions or decisions private — - always promote transparency.
• Speak on behalf of the podling — - the community should represent itself.
• Override community consensus — - mentors advise, not dictate.

...

4.4 Encouraging Healthy Decision-Making

Guide podlings to make in making decisions openly on the mailing list using through community consensus. Promote a lazy consensus for routine matters and reserve formal votes for key actions like , such as releases or adding committers/PPMC members.

...

• Listen carefully before advising.
• Empower podlings to lead collaboratively, avoiding micromanagement.
• Teach The the Apache Way and explain why the rationale behind its policies and processes exist.
• Encourage transparency in all discussions, reinforce the use of the mailing list use , and promote open decision-making.
• Promote inclusivity and respect—model respect, model welcoming, constructive communication.
• Provide timely feedback — , especially on reports and releases.
• Support independence — , step back as the podling becomes self-sustaining.
• Be patient and persistent — incubation .  Incubation can take time.

...

7. FAQ for Mentors

...

Q: How can I help podlings attract and retain new contributors?
A: Encourage clear documentation, welcoming communication, and inclusive community practices. Highlight opportunities for new contributors to get involved early and ways for teh thr the podling to promote itself.

...

Q: How should I handle late or missing reports?
A: Reach out to the podling promptly to understand the causes and offer assistance. Escalate to the Incubator PMC if reports continue to remain overdue or incomplete.

...

8. Reviewing Podling Reports

Podling Podlings reports keep the Incubator PMC and ASF Board informed about the project's status and health.

8.1 A Good Report Should:

• Be clear, concise, and well-organized.
• Summarize milestones, releases, and community activity.
• Provide an honest health assessment, including risks or blockers.
• Report governance updates and community dynamics.
• Outline plans, priorities, and needed support.
• Demonstrate policy compliance.
• Explain relevant metrics with context, not rather than just presenting raw data.
• Reflect progress toward graduation readiness.
• Be understandable to readers unfamiliar with the project

...

• Lack of transparency or secretive decisions.
• Slow ASF infrastructure adoption.
• Dominance by one company or individual.
• Low community engagement or contributor loss.
• Non-compliance with ASF policies.
• Conflicts or disruptive behavior within the community.
• Legal or licensing concerns.
• Slow to make releases.
• Staying too long more than 3-4 years in the Incubator.

Escalate serious issues to the Incubator PMC or ASF officers promptly.

...

• Building a sustainable, active community with steady growth and diverse contributors.
• Maintaining transparent, meritocratic governance following The Apache Way.
• Fully adopting ASF infrastructure and complying with ASF The ASFs policies.
• Delivering successful releases under ASF licensing requirements.
• Growing the PPMC and increasing the number of project committers.
• Respecting ASF trademarks and branding guidelines.
• Completing the Incubator graduation vote successfully.

...

11. Mentor Offboarding Process

After graduation or the retirement of a podling, mentors can provide feedback.

11.1 Reflect on the Mentorship Experience

Review the Best Practices for Mentors and Mentor Onboarding documents, documenting key takeaways on what worked well and areas for improvement.

11.2 Provide Feedback (Optional)

Share feedback with the podling on strengths and areas for growth. Optionally, provide feedback to the Incubator PMC on the mentoring process.

...

11. Contact Points and Support

• Incubator PMC Mailing Lists:
  • General: general@incubator.apache.org
  • Private: private@incubator.apache.org
• ASF Infrastructure: https://infra.apache.org/ASF Conduct Committee: For conduct issues.contact.html
• ASF Legal Affairs: For licensing or trademark questions. https://www.apache.org/legal/
• Incubator Website: https://incubator.apache.org/

...

• Be clear and concise; avoid unexplained jargon.
• Be patient and respectful of diverse backgrounds.
• Encourage open, public mailing list discussions.
• Use inclusive language.
• Be mindful of time zones and the nature of asynchronous communication.
• Listen actively and acknowledge contributions.
• Encourage questions and feedback.
• Model The Apache Way in interactions.
• Handle conflicts calmly; escalate if needed.
• Use multiple channels wisely, complementing mailing lists.

...

13. Resources for Mentors

The following references provide essential guidance for mentoring in the Apache Incubator. They cover governance, policies, and best practices for supporting podlings.

• Apache Incubator Website - The main entry point for information about the Incubator, including current podlings, policies, and documentation.

• Mentor Handbook -  The central reference tying together all mentor responsibilities, guidance, and training materials.

• Incubator General Mailing List - The open list for discussions about incubation, mentoring, and podling progress. A valuable channel for sharing experiences and asking questions.

• Incubator Policy - Defines the formal rules of incubation, including podling requirements, releases, and graduation.

• Mentor Responsibilities - Outlines the expected duties of mentors, including reporting, voting, and community guidance.

• The Apache Incubator Cookbook - Practical, step-by-step advice for podlings and mentors on common tasks and challenges.

• ASF Maturity Model - Framework to evaluate a podling’s readiness for graduation based on community and process maturity.

• The Apache Way - Core ASF philosophy: meritocracy, transparency, open collaboration, and community-driven governance.

• Best Practices for Mentors - Guidance on effective mentoring approaches, with real-world advice for supporting podlings.

• ASF Infrastructure Wiki - Information on mailing lists, version control, issue trackers, and other ASF-provided infrastructure.

• ASF Legal Resources - Policies on licensing, IP clearance, and handling third-party code.

• Distribution Guide - Instructions for properly publishing and distributing releases under ASF rules.

• Assembling License and Notice Files - Requirements and examples for creating compliant LICENSE and NOTICE files.

• ASF 3rd Party Licensing Policy - Clarifies what third-party dependencies may be included in ASF projects and under which conditions.

• Apache Voting Guide - Explains ASF voting processes, including consensus, majority votes, and binding vs. non-binding votes.

• ASF Code of Conduct - Sets expectations for respectful, inclusive behavior across ASF projects.

• Retiring Podlings - Outlines the process for retiring inactive or stalled podlings from the Incubator.

13.1 Training Resources

In addition to the written resources above, the Incubator provides some draft interactive training materials for Mentors and IPMC members. These resources help reinforce best practices and prepare you for mentoring podlings effectively:

• IPMC Mentor Quiz - Knowledge check on mentor responsibilities and ASF processes.

• IPMC Mentor Scenarios - Practical mentoring challenges and decision-making exercises.

• IPMC Incubator Quiz - Knowledge check on Incubator policies, reporting, and processes.

• IPMC Scenarios - Case studies on incubation challenges such as graduation readiness, community health, and governance.

We welcome feedback on this material, especially suggestions for improvements or corrections.

Privacy Notice

These quizzes are hosted on a third-party platform (Canvas). The ASF does not have a Data Processing Agreement (DPA) with this provider. Please take standard precautions regarding privacy and personal data.

To the best of our knowledge, the platform is GDPR compliant and collects only minimal personal information (name, email address, and possibly IP address). No additional personal data is tracked or retained.

...

14. Conflict of Interest

Mentors must maintain impartiality and transparency.

• Disclosure: Openly Clearly disclose any potential conflicts to the Incubator PMC and the podling community.
• Avoidance: Avoid situations impairing Refrain from situations that may compromise impartiality.
• Recusal: Recuse yourself from related discussions or votes.

If you are unsure, please consult the Incubator PMC.

...

• ASF (Apache Software Foundation): The non-profit organization that oversees Apache projects and their governance.
• Podling: A project incubating within the Apache Incubator, working toward becoming a top-level Apache project.
• PMC (Project Management Committee): A group responsible for the management and oversight of an Apache project.
• PPMC (Podling PMC): The group responsible for the podling’s governance and project management during incubation.
• Incubator PMC: The group that oversees the incubation process and mentors.
• The Apache Way: The ASF’s philosophy emphasizing community-led development, meritocracy, transparency, and openness.
• Lazy Consensus: A decision-making process where in which a lack of objection within a given timeframe implies consent.
• Committer: A Generally, a contributor with write access to the project’s code repository. Committers focusing on contributions related to documentation or testing may have limited access to the code repository
• Release Vote: A formal vote within the The ASF to approve a new official release of the software.
• Graduation: The process by which a podling becomes a fully-fledged Apache top-level project.

...