From e3481cfabf0ce8cedeb976add6695b6b016d4909 Mon Sep 17 00:00:00 2001 From: Julian Giebel Date: Sun, 8 Mar 2026 16:01:37 +0100 Subject: [PATCH 1/3] Create trial-maintainers.md Trail maintainer and mentoring document go brrrr --- .../maintainer/trial-maintainers.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 src/en/wizden-staff/maintainer/trial-maintainers.md diff --git a/src/en/wizden-staff/maintainer/trial-maintainers.md b/src/en/wizden-staff/maintainer/trial-maintainers.md new file mode 100644 index 0000000000..eb356b1014 --- /dev/null +++ b/src/en/wizden-staff/maintainer/trial-maintainers.md @@ -0,0 +1,23 @@ +# Trial maintainers & Mentoring + +Trial maintainers are candidates for full maintainer-ship, who are under supervision by a full maintainer tutoring them and giving them the chance to improve their knowledge about programming and the codebase. This includes a basic introduction into our tooling, workflows, meetings and getting accustomed to how maintainers handle everyday tasks. + +The role is intended to allow us to recruit more people as upstream maintainers and help with the onboarding process as a whole. Since trial maintainers don't have as much codebase knowledge yet, mistakes are something we expect to happen and the mentoring maintainer will serve as a safety net to keep up code quality and avoid bugs in the game. + +Our focus for trial maintainers and their mentoring is to teach and support them during their trial period. Helping them aquire a sense for healthy programming practices that would otherwise take a long time to build up on their own. + +## Trial maintainer application +After their application trial maintainers will be accepted through the same vote normal maintainers require. In addition maintainers will look at their previous coding work listed in their application and ask the person who vouched for them about their behaviour in other communities to make sure they are a good fit for our staff. Trial maintainers can only be accepted if a maintainer volunteers as a mentor. + +## Peer Reviews +Mentors hold occasional peer reviews in a voicechat with their assigned trial maintainers to facilitate teaching them how to spot problematic code, how to communicate with contributors in a constructive way and answer any questions that come up during the review. + +Additionally an introductory onboarding session will be held shortly after the applicant got accepted. + +## Trial maintainer-ship duration +(The preliminary trail duration is 2 months. This may be adjusted later, after the first few trials passed). After the trial period the assigned mentor presents their opinion on the trial maintainer and maintainers will vote on whether their trial continues, ends or they get accepted as a full maintainer. + +## Limitations +- No PII access (Grafana etc.) +- No codermin in-game permissions +- An additional maintainer approval is required for merging PRs until the mentoring maintainer decides they are fit to follow the normal PR review policy. From 4a0c42963055d71c9dc8885987e52d9ad4ddcd96 Mon Sep 17 00:00:00 2001 From: Julian Giebel Date: Sun, 8 Mar 2026 16:04:15 +0100 Subject: [PATCH 2/3] Update SUMMARY.md --- src/SUMMARY.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/SUMMARY.md b/src/SUMMARY.md index bdd709ca0a..0f08b917b2 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -371,6 +371,7 @@ Staff - [Hotfix Procedure](en/wizden-staff/maintainer/hotfix-procedure.md) - [Triage Procedure](en/wizden-staff/maintainer/triage-procedure.md) - [Release Procedure](en/wizden-staff/release-procedure.md) + - [Trial Maintainers & Mentoring](en/wizden-staff/maintainer/trial-maintainers.md) - [Moderator](en/wizden-staff/moderator.md) - [Moderation Policy](en/wizden-staff/moderator/moderation-policy.md) - [New Moderator Guide](en/wizden-staff/moderator/new-mod-guide.md) From bff35fdae4438f821cd785de35955d89e02970df Mon Sep 17 00:00:00 2001 From: Julian Giebel Date: Sun, 8 Mar 2026 17:26:08 +0100 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Rem --- .../wizden-staff/maintainer/trial-maintainers.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/en/wizden-staff/maintainer/trial-maintainers.md b/src/en/wizden-staff/maintainer/trial-maintainers.md index eb356b1014..bc56a41d8c 100644 --- a/src/en/wizden-staff/maintainer/trial-maintainers.md +++ b/src/en/wizden-staff/maintainer/trial-maintainers.md @@ -1,21 +1,21 @@ # Trial maintainers & Mentoring -Trial maintainers are candidates for full maintainer-ship, who are under supervision by a full maintainer tutoring them and giving them the chance to improve their knowledge about programming and the codebase. This includes a basic introduction into our tooling, workflows, meetings and getting accustomed to how maintainers handle everyday tasks. +Trial maintainers are candidates for full maintainer-ship who are under the supervision of a full maintainer, who tutors them and gives them the chance to improve their knowledge of programming and the codebase. This includes a basic introduction to our tooling, workflows, meetings, and getting accustomed to how maintainers handle everyday tasks. -The role is intended to allow us to recruit more people as upstream maintainers and help with the onboarding process as a whole. Since trial maintainers don't have as much codebase knowledge yet, mistakes are something we expect to happen and the mentoring maintainer will serve as a safety net to keep up code quality and avoid bugs in the game. +The role is intended to enable us to recruit more people as upstream maintainers and to support the onboarding process overall. Since trial maintainers don't have as much codebase knowledge yet, we expect mistakes, and the mentoring maintainer will serve as a safety net to maintain code quality and avoid bugs in the game. -Our focus for trial maintainers and their mentoring is to teach and support them during their trial period. Helping them aquire a sense for healthy programming practices that would otherwise take a long time to build up on their own. +Our focus for trial maintainers and their mentoring is to teach and support them during their trial period. Helping them acquire a sense for healthy programming practices that would otherwise take a long time to build up on their own. ## Trial maintainer application -After their application trial maintainers will be accepted through the same vote normal maintainers require. In addition maintainers will look at their previous coding work listed in their application and ask the person who vouched for them about their behaviour in other communities to make sure they are a good fit for our staff. Trial maintainers can only be accepted if a maintainer volunteers as a mentor. +After their application trial, maintainers will be accepted through the same vote that normal maintainers require. In addition, maintainers will look at their previous coding work listed in their application and ask the person who vouched for them about their behaviour in other communities to make sure they are a good fit for our staff. Trial maintainers can only be accepted if a maintainer volunteers as a mentor. ## Peer Reviews -Mentors hold occasional peer reviews in a voicechat with their assigned trial maintainers to facilitate teaching them how to spot problematic code, how to communicate with contributors in a constructive way and answer any questions that come up during the review. +Mentors hold occasional peer reviews in a voice chat with their assigned trial maintainers to teach them how to spot problematic code, communicate with contributors constructively, and answer any questions that come up during the review. -Additionally an introductory onboarding session will be held shortly after the applicant got accepted. +Additionally, an introductory onboarding session will be held shortly after the applicant has been accepted. ## Trial maintainer-ship duration -(The preliminary trail duration is 2 months. This may be adjusted later, after the first few trials passed). After the trial period the assigned mentor presents their opinion on the trial maintainer and maintainers will vote on whether their trial continues, ends or they get accepted as a full maintainer. +(The preliminary trial duration is 2 months. This may be adjusted later, after the first few trials have passed. After the trial period, the assigned mentor presents their opinion on the trial maintainer, and maintainers vote on whether the trial continues, ends, or is accepted as a full maintainer. ## Limitations - No PII access (Grafana etc.)