This is an automated email from the ASF dual-hosted git repository.
jmclean pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/training.git
The following commit(s) were added to refs/heads/develop by this push:
new 087d1c6 added feedback from mailing list
087d1c6 is described below
commit 087d1c609b9e0755b38cd8142d0e2ed0c70efd0b
Author: Justin Mclean <[email protected]>
AuthorDate: Mon Sep 8 23:29:16 2025 +1000
added feedback from mailing list
---
.../Incubator/Mentors/src/main/asciidoc/index.adoc | 57 +++++++++++-----------
1 file changed, 28 insertions(+), 29 deletions(-)
diff --git a/content/Apache/Incubator/Mentors/src/main/asciidoc/index.adoc
b/content/Apache/Incubator/Mentors/src/main/asciidoc/index.adoc
index 4509b11..c90e18e 100644
--- a/content/Apache/Incubator/Mentors/src/main/asciidoc/index.adoc
+++ b/content/Apache/Incubator/Mentors/src/main/asciidoc/index.adoc
@@ -34,7 +34,7 @@ Supporting Projects Using the Apache Way
[.notes]
--
-Welcome everyone, explain that this training is designed to prepare mentors
for supporting Apache Incubator podlings, emphasize that the focus is on both
technical processes and ASF culture, and share briefly your background with ASF
to establish context.
+Welcome everyone, explain that this training is designed to prepare mentors
for supporting Apache Incubator podlings, emphasize that the focus is on both
technical processes and ASF culture, and share briefly your background with The
ASF to establish context.
--
== Table of Contents
@@ -53,7 +53,7 @@ Present the training roadmap, explain the six main sections,
highlight that we w
== What You'll Learn
-* ๐งญ ASF Values & Culture - What makes ASF different
+* ๐งญ ASF Values & Culture - What makes The ASF different
* ๐ Releases & Graduation - Processes and pitfalls
* ๐ฅ Community & Oversight - Building sustainable projects
* ๐งโ๐ซ Mentoring in Practice - What mentors actually do
@@ -62,18 +62,18 @@ Present the training roadmap, explain the six main
sections, highlight that we w
[.notes]
--
-Explain that the session covers both theory and practice, emphasize that
mentors will learn not just the ASF rules but also how to guide communities
through them, and point out that each section has practical examples and advice
to take back to real mentoring situations.
+Explain that the session covers both theory and practice, emphasize that
mentors will learn not just The ASF rules but also how to guide communities
through them, and point out that each section has practical examples and advice
to take back to real mentoring situations.
--
== ASF Values & Culture
๐ ASF Culture: The Foundation of Everything
-Understanding the values that make ASF unique
+Understanding the values that make The ASF unique
[.notes]
--
-Introduce the ASF cultural foundation, stress that this culture is what
differentiates ASF from vendor-driven projects, and explain that every decision
and process flows from these values.
+Introduce the ASF cultural foundation, stress that this culture is what
differentiates The ASF from vendor-driven projects, and explain that every
decision and process flows from these values.
--
== Core Values
@@ -90,7 +90,7 @@ Walk through each value, explain that community over code
means people and proce
== Why It Matters
-* ๐ Distinguishes ASF from vendor-led models
+* ๐ Distinguishes The ASF from vendor-led models
* ๐ฑ Enables sustainable growth
* ๐ค Builds trust and inclusion
@@ -99,7 +99,7 @@ Walk through each value, explain that community over code
means people and proce
Explain that these values protect projects from capture, they allow
communities to grow sustainably over time, and they create trust and
inclusivity by making participation open to everyone.
--
-== Red Flags to Watch
+== Red Flags to Watch For
* ๐ Private decision-making
* ๐ช Leadership by title or company role
@@ -124,14 +124,14 @@ Explain that mentors lead by example, they should model
ASF values in their beha
== ASF Governance: Where Mentors Fit In
-* ๐ฅ ASF Board โ Oversees all ASF projects and PMCs
+* ๐ฅ The ASF Board โ Oversees all ASF projects and PMCs
* ๐ข IPMC โ Manages incubation and mentors podlings
* ๐จโ๐ฉโ๐งโ๐ฆ PPMC โ Runs the day-to-day of the podling
-* ๐งโ๐ซ Mentors โ Bridge between the ASF and the podling
+* ๐งโ๐ซ Mentors โ Bridge between The ASF and the podling
[.notes]
--
-Explain the structure of ASF governance, clarify that mentors serve as a
bridge between podlings and the ASF, stress that mentors are not managers but
guides, and show how responsibilities flow from Board to IPMC to PPMC.
+Explain the structure of ASF governance, clarify that mentors serve as a
bridge between podlings and The ASF, stress that mentors are not managers but
guides, and show how responsibilities flow from Board to IPMC to PPMC.
--
== Releasing at Apache
@@ -196,7 +196,7 @@ Explain that mentors guide podlings through their first
releases, review artifac
== ASF Branding & Trademarks
-๐จ Branding isnโt just visual - itโs how the project represents the ASF
+๐จ Branding isnโt just visual - itโs how the project represents The ASF
[.notes]
--
@@ -216,7 +216,7 @@ Explain each branding rule, stress that podlings must
include โ(incubating)โ
== ASF Name Misuse
-* ๐ข Donโt use the ASF Name to Promote Vendor Products
+* ๐ข Donโt use the ASF Name to promote vendor products
* ๐ ASF project != your product
* ๐ฃ Marketing must not imply ASF endorsement
* โ๏ธ When in doubt, ask [email protected]
@@ -274,7 +274,7 @@ Walk through the criteria, explain why each matters, and
emphasize that graduati
* ๐ฃ๏ธ PPMC discusses readiness
* ๐ณ๏ธ PPMC votes
* ๐ฅ IPMC votes
-* ๐๏ธ ASF Board approves
+* ๐๏ธ The ASF Board gives final approval
[.notes]
--
@@ -295,13 +295,13 @@ Explain that graduation is not a box-ticking exercise,
emphasize that independen
== What Happens After Graduation
* ๐๏ธ Project becomes a Top-Level Project
-* ๐ Reports directly to ASF Board
+* ๐ Reports directly to The ASF Board
* ๐ฆ Manages own releases and branding
* ๐ Drops โ(incubating)โ from its name
[.notes]
--
-Explain what changes after graduation, emphasize that the podling becomes
fully independent, reports directly to the ASF Board, and no longer requires
mentor oversight.
+Explain what changes after graduation, emphasize that the podling becomes
fully independent, reports directly to The ASF Board, and no longer requires
mentor oversight.
--
== Mentorโs Role (Graduation)
@@ -385,7 +385,7 @@ Introduce ASF voting, explain that it formalizes consensus,
and emphasize that i
== Decision-Making the Apache Way
-* ๐ณ๏ธ Votes enable consensus
+* ๐ณ๏ธ Votes can record consensus
* ๐ฌ dev@ is the central place for decisions
* ๐ค Consensus > control
* ๐ Documented > assumed
@@ -412,7 +412,7 @@ List the actions that require votes, explain why formal
consensus is needed, and
* โ
+1 = Approve
* โ 0 = No opinion
* โ -1 = Block (with explanation)
-* Binding = IPMC member
+* Binding = IPMC member (during incubation)
[.notes]
--
@@ -445,7 +445,7 @@ Explain that mentors should teach voting expectations,
ensure discussions happen
== Independence vs Corporate Influence
-๐ข Independence isnโt just ideal - itโs essential to ASF governance
+๐ข Independence isnโt just ideal - itโs essential to The ASF and it's projects
[.notes]
--
@@ -478,7 +478,7 @@ Explain that mentors must actively encourage diversity,
support contributions fr
== Podling Reporting & Oversight
-๐ Reporting isnโt just paperwork - itโs how we ensure accountability and
support
+๐ Reporting isnโt just paperwork - itโs shows progress and ensures support
[.notes]
--
@@ -487,15 +487,15 @@ Introduce reporting as a governance requirement, explain
that it builds transpar
== Why Reporting Matters
-* ๐ Keeps ASF informed
+* ๐ Keeps The ASF informed
* ๐ Identifies risks
* ๐ข Builds transparency
* ๐ ๏ธ Enables mentor/IPMC support
-๐ฎ Due quarterly โ add to wiki
+* ๐ฎ Due quarterly โ add to wiki
[.notes]
--
-Explain the value of reports, emphasize that they inform the ASF, surface
risks, and invite support from mentors and the IPMC when needed.
+Explain the value of reports, emphasize that they inform The ASF, surface
risks, and invite support from mentors and the IPMC when needed.
--
== What Goes in a Podling Report
@@ -521,7 +521,7 @@ Explain the components of a podling report, stress that
honesty is more importan
[.notes]
--
-Describe the IPMC perspective, explain that they want to see broad
participation, activity on mailing lists, consistent releases, independence,
and cultural alignment with ASF.
+Describe the IPMC perspective, explain that they want to see broad
participation, activity on mailing lists, consistent releases, independence,
and cultural alignment with The ASF.
--
== Oversight Red Flags
@@ -530,7 +530,7 @@ Describe the IPMC perspective, explain that they want to
see broad participation
* ๐ Private decisions
* ๐ข One-company dominance
* ๐ซ Missed or unclear reports
-* ๐ฏ Repeated release or IP issues
+* ๐ฏ Repeated release issues or IP issues
[.notes]
--
@@ -669,7 +669,7 @@ Conflict is a natural part of ASF projects, it can show up
as technical debates
* ๐ Decisions without discussion
* ๐ค Newcomers ignored
* ๐ Declining dev@ engagement
-* ๐ง One person doing all work
+* ๐ง One person doing all the work
[.notes]
--
@@ -707,16 +707,16 @@ Explain that mentors should listen to all sides, ensure
transparency by keeping
* ๐ค Resolve on dev@ first
* ๐ง Contact [email protected]
* โ๏ธ Escalate to IPMC
-* ๐ ๏ธLegal/misconduct โ ASF Board
+* ๐ ๏ธLegal/misconduct โ The ASF Board
[.notes]
--
-Explain the escalation ladder, emphasize starting with dev@, then moving to
private@ if unresolved, escalating to the IPMC for ongoing issues, and
involving the ASF Board for legal or serious misconduct.
+Explain the escalation ladder, emphasize starting with dev@, then moving to
private@ if unresolved, escalating to the IPMC for ongoing issues, and
involving The ASF Board for legal or serious misconduct.
--
== Whatโs Next?
-๐ฑ Mentoring at ASF means growing communities, not just guiding projects
+๐ฑ Mentoring at The ASF means growing communities, not just guiding projects
[.notes]
--
@@ -748,4 +748,3 @@ Reinforce the most important lessons, remind mentors to
model culture, encourage
--
Close with resources, explain where mentors can find more information,
encourage participation on mailing lists, remind them of the mentor guide, and
point out that IPMC support is always available.
--
-
