Page MenuHomePhabricator

Design: Mentorship module for experienced editors
Closed, ResolvedPublic

Assigned To
Authored By
KStoller-WMF
Apr 16 2024, 7:28 PM
Referenced Files
F64329235: image.png
Jul 14 2025, 9:29 AM
F63916854: image.png
Jul 14 2025, 9:14 AM
F63916832: image.png
Jul 14 2025, 9:14 AM
F63916887: image.png
Jul 14 2025, 9:14 AM
F63780688: image.png
Jul 10 2025, 4:18 PM
F63781122: image.png
Jul 10 2025, 4:18 PM
F63780625: image.png
Jul 10 2025, 4:18 PM
F63780392: CleanShot 2025-07-10 at 17.59.09@2x.png
Jul 10 2025, 4:18 PM

Description

User story & summary:

As an experienced editor who visits the Newcomer Homepage,

  • I do not want to be assigned a Mentor, because I no longer need newcomer support.
  • I want to learn about the Mentorship feature, so I can consider supporting new editors myself.

As a Mentor, I do not want experienced editors assigned to me as Mentees, because it creates confusion and reduces my ability to focus on newcomers who need help.

Background & research:

This task is important because:

  1. The current logic is confusing both for Mentors and Experienced Editors who are auto-assigned a Mentor
  2. Mentors are busy, we should work towards reducing the number of mentees they support.
  3. We need more Mentors! This is a logical way to spread the word and encourage more editors to join Mentorship.
  4. This is another small way that we can "level up" new editors as they "graduate" on from being a mentee, to being invited to act as a mentor.
  5. Mentors are Asking for this:

The homepage tab could be tweaked to say after the six months something like "Congratulations, you are now experienced enough not to need a mentor! Use the Help Desk if you need advice from now on." instead of giving a name. I'd also suggest that anyone who activates the newcomer homepage when they already have over six month's experience should get that message. (I was amused that when I activated the tab to see what it did, I was auto-assigned someone less experienced than I am.)

Questions:

How should we handle junior editors who have Mentors and then pass this threshold where they are eligible to become a Mentor?

For experienced editors, should this module be dismissible?

  • Ideally yes, however the Homepage doesn't yet include personal settings or the ability to dismiss or reenable modules. So perhaps this should be considered separately?

For autocreated accounts: when experienced editors navigate to a different language wiki (and enable the Homepage), do we consider their Global edit count, or just their local wiki edit count?

We should keep the copy succinct, but link out to further details if needed. Where should we link?

Copy:
Design:

image.png (1×750 px, 241 KB)

NOTE: please refer to the figma file for all the variants, and detailed specs on layout and spacing
Acceptance Criteria:

Given I'm an editor that meets the Mentorship criteria defined in Community Configuration.
When I visit the Homepage,
Then the Mentorship module invites me to consider becoming a Mentor rather than assigning me a Mentor.

Event Timeline

To be decided: do we consider the Global edit count or just the wiki specific edit count?

AAlhazwani-WMF changed the task status from Open to In Progress.Jul 4 2025, 4:21 PM
AAlhazwani-WMF moved this task from Incoming to Doing on the Growth-Team (Current Sprint) board.
AAlhazwani-WMF subscribed.

sharing some initial ideas!

so, the most basic thing that we could do is to not assign a mentor to editors with more than X (500?) edits? it would look like when newcomers opt out of mentorship.

image.png (470×714 px, 36 KB)

this is not ideal, so we could simply hide the module if the editor has more that X edits? doable, but it feels like a lost opportunity.

image.png (670×1 px, 122 KB)

so, trying to take on this opportunity the most minimal intervention would be to create a module to invite experience editors to become a mentor. "Enroll" links to Special:EnrollAsMentor so we should consider if it should be displayed as a link (to reinforce semantics) or if we want to make the action more prominent, and style this as a button.

image.png (336×596 px, 21 KB)

we hear there is a desire to provide further details if needed. this could take different shapes, but it could be as simple as a "Learn more" link. we could provide a good default, while still give the option to community admins to specify a different destination via the community config.

image.png (380×596 px, 24 KB)

to answer some of the questions in the task description:

How should we handle junior editors who have Mentors and then pass this threshold where they are eligible to become a Mentor?

we could think of different solutions here: from asking if they want to continue be mentored, to simply opt-out, of if they want to try to become a mentor. i'd suggest to address this in a separate task after a first release.

For experienced editors, should this module be dismissible?

maybe. i'd suggest to roll out a first update, and then consider to make this dismissible in a separate task. what i can say is that we've identified a need to store this information also for other features, eg. things users dismissed, so it would be helpful to implement a "global" logic.

For autocreated accounts: when experienced editors navigate to a different language wiki (and enable the Homepage), do we consider their Global edit count, or just their local wiki edit count?

global edit count

We should keep the copy succinct, but link out to further details if needed. Where should we link?

+1 to https://www.mediawiki.org/wiki/Help:Growth/Mentorship

some other things that we've been exploring are...

newcomers are auto-assigned to a mentor. editors with more than X edits are asked if they want to become a mentor, is there anything in between? eg. not assigning/not asking for editors with an edit count between Y and X?

image.png (454×1 px, 75 KB)

on copy, we're wondering if there space to be less formal, eg. "Need a hand?", "Want to help out?"

image.png (448×1 px, 75 KB)

Here is the summary of the discussions we had during the Ambassadors meeting.

Moving from mentee to mentor
While 500 edits (the current default threshold in community configuration) is good enough at some wikis to become a mentor, at other wikis, more experience could be necessary. If we make the threshold of becoming a mentor too easy, it could impact the quality of mentorship and commitment.

We observed different needs:

  • French and Spanish have no conditions to become a mentor.
  • At English Wikipedia, participating at the Teahouse is seen as a good intermediate step before becoming a mentor.
  • At Arabic Wikipedia, users need to get the Editor right to become a mentor. That manually granted right is proof that you are trusted by others.

Possible ideas and further reading:

Opting in/ out of mentorship

  • As some mentors don't see a problem being monitored by another mentor, some may not like it. Mentorship is not friendship.
  • Should anyone be allowed to opt-out mentorship? Some users are not "ready" to be left unsupervised after $treshold edits.
  • Can we promote mentorship for users who get a new role? New rollbackers or new admins could get access to a mentor to learn about their first steps and the new tools they now have access to.

we could think of different solutions here: from asking if they want to continue be mentored, to simply opt-out, of if they want to try to become a mentor. i'd suggest to address this in a separate task after a first release.

The current task description seems to tight both together.
Based on the Ambassador's meeting suggestion, I would cover both, with opting-out from a mentor and opting-in as a mentor being triggered by two separate CC items:

  • offer to opt-out of mentorship when the user passes $opt-out threshold
  • offer to become a mentor when the user passes $opt-in threshold

For experienced editors, should this module be dismissible?

maybe. i'd suggest to roll out a first update, and then consider to make this dismissible in a separate task. what i can say is that we've identified a need to store this information also for other features, eg. things users dismissed, so it would be helpful to implement a "global" logic.

I think that it could be an expansion of the current mentorship module, with each button appearing when their threshold is met. This would keep things simpler. Perhaps I'm wrong, but the way the proposals are made is focusing on a new module, right?

For autocreated accounts: when experienced editors navigate to a different language wiki (and enable the Homepage), do we consider their Global edit count, or just their local wiki edit count?

global edit count

I would keep the local threshold, as the rules and culture are very different from one wiki to the other.
As a mentor, I received a few questions from users from different wikis, and they were happy to find someone to help them on a specific point. However, as a mentor, I don't like to know that my mentor at another wiki changes when I don't edit this wiki. :) (But this is outside of this task's scope.)

thank for the all the feedback @Trizek-WMF!

we could think of different solutions here: from asking if they want to continue be mentored, to simply opt-out, of if they want to try to become a mentor. i'd suggest to address this in a separate task after a first release.

The current task description seems to tight both together.
Based on the Ambassador's meeting suggestion, I would cover both, with opting-out from a mentor and opting-in as a mentor being triggered by two separate CC items:

  • offer to opt-out of mentorship when the user passes $opt-out threshold
  • offer to become a mentor when the user passes $opt-in threshold

yeah, that makes sense. here's a quick take on the idea (threshold, and copy are work-in-progress)

CleanShot 2025-07-10 at 17.59.09@2x.png (1×1 px, 333 KB)

For experienced editors, should this module be dismissible?

maybe. i'd suggest to roll out a first update, and then consider to make this dismissible in a separate task. what i can say is that we've identified a need to store this information also for other features, eg. things users dismissed, so it would be helpful to implement a "global" logic.

I think that it could be an expansion of the current mentorship module, with each button appearing when their threshold is met. This would keep things simpler. Perhaps I'm wrong, but the way the proposals are made is focusing on a new module, right?

i was thinking about a whole new module, beside the 2 that we already have:

  1. module for newcomers (and editors who open the homepage, and that are below the community set threshold to auto-assign a mentor)
    image.png (1×750 px, 249 KB)
  2. module for editors who visit the homepage (with an edit count between the 2 thresholds: they are above the one to auto-assign a mentor, and below the one to enroll as a mentor). this is already what is shown in production if you opt-out of mentorship
    image.png (1×750 px, 244 KB)
  3. module for experienced editors (if they are above the threshold set by the local community to enroll as a mentor). copy is work-in-progress.
    image.png (1×750 px, 242 KB)

For autocreated accounts: when experienced editors navigate to a different language wiki (and enable the Homepage), do we consider their Global edit count, or just their local wiki edit count?

global edit count

I would keep the local threshold, as the rules and culture are very different from one wiki to the other.
As a mentor, I received a few questions from users from different wikis, and they were happy to find someone to help them on a specific point. However, as a mentor, I don't like to know that my mentor at another wiki changes when I don't edit this wiki. :) (But this is outside of this task's scope.)

yeah, that's a valid point. agree with you on following the local thresholds.

after consulting with @KStoller-WMF we landed on simpler solution for the first iteration. we're going to keep the CC as is, and use the current setting to inform which module to display.

for newcomers we keep the current logic, they are auto-assigned to a mentor.

image.png (1×750 px, 249 KB)

(edge case) for editors below the threshold, if they don't have a mentor assigned, and they visit the homepage, we don't auto-assigned, but we display the same module that we display to newcomers when they opt-out of mentorship.

image.png (1×750 px, 243 KB)

for editors above the threshold, we display a new module that invite them to become a mentor. learn more link goes to https://www.mediawiki.org/wiki/Help:Growth/Mentorship. become an editor link goes to special:enrollasmentor

image.png (1×750 px, 241 KB)

NOTE: please refer to the figma file for all the variants, desktop versions, and detailed specs on layout and spacing.

I've created a follow-up engineering task here: T403540: Mentorship module for experienced editors, and I believe we can consider this task resolved.