You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@incubator.apache.org by jm...@apache.org on 2026/08/24 12:04:39 UTC
(incubator) 01/03: update docs
This is an automated email from the ASF dual-hosted git repository.
justinmclean pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator.git
commit f03c2a400556b1cd220bf4734de6af421881f8c5
Author: Justin Mclean <jm...@apache.org>
AuthorDate: Mon Aug 24 13:44:47 2026 +1000
update docs
---
tools/ai-tutor/README.md | 4 ++++
tools/ai-tutor/ROADMAP.md | 17 +++++++++++++----
tools/ai-tutor/SOURCES.md | 8 +++++++-
3 files changed, 24 insertions(+), 5 deletions(-)
diff --git a/tools/ai-tutor/README.md b/tools/ai-tutor/README.md
index a5ae7f692..37a7b90c0 100644
--- a/tools/ai-tutor/README.md
+++ b/tools/ai-tutor/README.md
@@ -54,6 +54,10 @@ rather than pad when a learner is answering well.
| [12. Anatomy of a podling release](lesson-12-anatomy-of-a-podling-release.md) | D, Releases | What counts as a release and what does not, what a source package must contain and what a convenience binary may be, signing, checksums and KEYS, where artifacts live from staging to archive, and what is different because the project is a podling. | ~35 min |
| [13. Running a release vote](lesson-13-running-a-release-vote.md) | D, Releases | Chaining the two stages and what must travel between them, calling a vote a reviewer can act on, the arithmetic of majority approval, who binds where, answering review feedback, and closing the vote so the record is usable. | ~35 min |
| [14. Announcing and distributing](lesson-14-announcing-and-distributing.md) | D, Releases | The order between a passed vote and a sent announcement, where a release lives and what happens automatically, what a download page must contain, what an announcement must link and never point at, the other channels projects publish to, and correcting what is already out. | ~35 min |
+| [15. What a mentor actually does](lesson-15-what-a-mentor-actually-does.md) | E, Mentoring | What a mentor is accountable for and to whom, what they do not do, becoming a mentor, the first weeks, when to watch and when to step in, reports and sign-off, escalation, conflict of interest, and judging your own engagement. | ~35 min |
+| [16. Reading the signals](lesson-16-reading-the-signals.md) | E, Mentoring | What the red flags are and are not, reading a podling report, measuring health without scoring it, the four mentor-podling archetypes, and why a signal is evidence to check rather than a verdict to deliver. | ~35 min |
+| [17. Difficult conversations](lesson-17-difficult-conversations.md) | E, Mentoring | Behaviours rather than people, questions before assertions, the eight named situations and their pitfalls, where a conversation belongs, when it is not a wording problem at all, and closing the loop. | ~35 min |
+| [18. Mentor lifecycle: selection, replacement, offboarding](lesson-18-mentor-lifecycle.md) | E, Mentoring | Who is eligible to mentor and how to become eligible, choosing a balanced team and the common mistakes, how many mentors and at what strength, recognising when coverage has thinned, running a replacement, and what happens at graduation and retirement. | ~35 min |
Twenty-six lessons are planned across eight tracks: Foundations, podling startup
and PPMC, legal and branding, releases, mentoring, IPMC oversight, graduation
diff --git a/tools/ai-tutor/ROADMAP.md b/tools/ai-tutor/ROADMAP.md
index 2954f63d6..61ca91c2d 100644
--- a/tools/ai-tutor/ROADMAP.md
+++ b/tools/ai-tutor/ROADMAP.md
@@ -144,10 +144,19 @@ The next lesson is 15, which begins Track E.
| # | Lesson | Source pages | Status |
|---|---|---|---|
-| 15 | What a mentor actually does | Incubator Mentor Quick Start Guide, Mentor Onboarding, Mentor Handbook | Next |
-| 16 | Reading the signals | Common Red Flags, Measuring Podling Health, Mentor Engagement Patterns, Best Practices for Mentors | Planned |
-| 17 | Difficult conversations | Mentors Tough Conversation Guide | Planned |
-| 18 | Mentor lifecycle: selection, replacement, offboarding | Select Your Mentors, Mentor Replacement, Mentor Offboarding | Planned |
+| 15 | What a mentor actually does | Incubator Mentor Quick Start Guide, Mentor Onboarding, Mentor Handbook | **Done** |
+| 16 | Reading the signals | Common Red Flags, Measuring Podling Health, Mentor Engagement Patterns, Best Practices for Mentors | **Done** |
+| 17 | Difficult conversations | Mentors Tough Conversation Guide | **Done** |
+| 18 | Mentor lifecycle: selection, replacement, offboarding | Select Your Mentors, Mentor Replacement, Mentor Offboarding | **Done** |
+
+Track E is the first track written for mentors rather than podling members,
+which changes the hard rule in every lesson: the tutor teaches the judgement and
+refuses to exercise it. Lesson 15 works from the mentor quick start, onboarding
+and handbook pages; Lesson 16 from the red flags sheet, the health and
+engagement analyses and Best Practices; Lesson 17 from the Tough Conversation
+Guide; Lesson 18 from Select Your Mentors, Mentor Replacement and Mentor
+Offboarding, with the PPMC and Mentors' guides for the mechanics the wiki pages
+do not carry.
## Track F: IPMC oversight
diff --git a/tools/ai-tutor/SOURCES.md b/tools/ai-tutor/SOURCES.md
index 319a996dc..aa15e8bde 100644
--- a/tools/ai-tutor/SOURCES.md
+++ b/tools/ai-tutor/SOURCES.md
@@ -17,7 +17,10 @@ lives on the main ASF site rather than the wiki.
Tracks C and D are the exception to "wiki guides feed the lessons". Their
subjects are Foundation-wide rather than Incubator practice, so Lessons 9 to 14
take their teaching shape from the wiki guides listed below but take anything
-normative from ASF and Infrastructure pages that are not in the index:
+normative from ASF and Infrastructure pages that are not in the index. Lesson 18
+is a smaller exception of the same kind: the mentor wiki pages describe the
+practice, while the eligibility rule and the mechanics for changing a mentor
+sit on the Incubator's own site guides. Those sources:
| Source | Lesson | What it covers |
|---|---|---|
@@ -48,6 +51,9 @@ normative from ASF and Infrastructure pages that are not in the index:
| [Incubator distribution guidelines](https://incubator.apache.org/guides/distribution.html) | 12, 14 | Convenience binaries, and the conditions on Maven, GitHub, Docker Hub and package registries. |
| [Incubator publicity guide](https://incubator.apache.org/guides/publicity.html) | 14 | What a podling is encouraged to do publicly, and the newswire restriction. |
| [Handling cryptography](https://infra.apache.org/crypto.html) | 12 | When the export control obligation attaches, and what the steps are. |
+| [PPMC guide](https://incubator.apache.org/guides/ppmc.html) | 18 | Adding and removing a mentor via the Whimsy podling roster, and that a mentor must be an IPMC member. |
+| [Mentors' guide](https://incubator.apache.org/guides/mentor.html) | 18 | That mentors must be on the IPMC, and the route for a prospective mentor to join. |
+| [Guide to retirement](https://incubator.apache.org/guides/retirement.html) | 18 | Who decides retirement, the IPMC vote, and that a mentor or other volunteer performs the wind-up. |
Incubation policy at
[incubator.apache.org/policy/incubation.html](https://incubator.apache.org/policy/incubation.html)
---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org