Page MenuHomePhabricator

EPIC: Provide a system to automatically suspend or remove mentors from the list of mentors
Open, HighPublic5 Estimated Story Points

Description

User story & summary:

As an experienced editor who cares about new editors, I want to ensure Mentors are active and responding to their mentees, so that new editors receive the onboarding and mentorship that they need.

Background & research:

This task is important because several communities have expressed a need for this feature, and some wikis have even developed bots to automatically handle this.

These communities either already have set rules, or have plans to set rules about inactive mentors:

  • Korean Wikipedia: Users who have not contributed at least 20 general namespace contributions and 10 discussion namespace contributions within the last 3 months will be deleted from the list.
  • Russian Wikipedia: Remove mentors after 30 days of inactivity
  • German Wikipedia: Remove mentors after 14 days of activity

Please note, this task does not require us to implement the above examples. The examples are only provided for context.

Acceptance Criteria:

Given I'm an admin,
When access Community Configuration for Mentorship,
Then I can see the following configuration variables:

Should inactive mentors be set to Away?
Yes / No

If Yes:

Number of days in which an editor will be automatically marked as Away from Mentorship if they are inactive:
#


Should inactive mentors be removed from Mentorship?
Yes / No

If Yes:

Number of days in which an editor will be automatically removed from Mentorship if they are inactive:
#


Adjust the logic / warning for Mentors who are setting themselves away:

  • Given I'm a Mentor who is marking myself as away,
  • When I choose an away period that is LONGER than the variable set by the community via the Community Configuration for "Number of days in which an editor will be automatically removed from Mentorship if they are inactive"
  • Then I receive an error message that indicates I can't set my Away time for longer than the number of days in which an editor will be automatically removed from Mentorship if they are inactive.

NOTE: This feature should be disabled ("No" / "No") by default when released. Once enabled ("Yes" is selected), then defaults can be: 10 days of inactivity to be set to "Away" and 30 days of inactivity for Removal.

Related Objects

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes
KStoller-WMF removed Due Date which was set to Dec 15 2023, 8:00 AM.Jan 9 2024, 5:53 PM
Aklapper changed the subtype of this task from "Deadline" to "Task".Nov 26 2024, 8:23 PM

English Wikipedia has templates like {{Retired}}, where if an editor uses it it might make sense to mark them as inactive.

English Wikipedia has templates like {{Retired}}, where if an editor uses it it might make sense to mark them as inactive.

That would be T370985

Another idea that came up at https://en.wikipedia.org/wiki/Wikipedia_talk:Growth_Team_features#Mentor_inactivity_threshold is checking whether they've been answering questions.

Thanks, I agree that's what we ultimately care about: are Mentors failing to respond to questions and failing to support the mentees assigned to them. From a technical perspective, I imagine checking specific talk page message responses is more challenging (and prone to error) than just checking a "last active" timestamp, but we can consider it when we have time to address this.

I had hoped we could address this during the recent sprint focused on Mentorship tasks, but we weren’t able to complete it then. I'll see if we can find a way to squeeze in this work soon.

Arabic Wikipedia: community decided 14 days of inactivity to remove mentors.

checking specific talk page message responses

Edge case to consider: Sometimes mentee messages are spammy or off-topic enough that even a good Mentor might reasonably decide to not respond.
Example discussion on enwiki: Question_regarding_mentee_questions.

KStoller-WMF raised the priority of this task from Medium to High.Oct 27 2025, 5:15 PM
KStoller-WMF removed the point value 5 for this task.Apr 1 2026, 4:28 PM

Growth team engineers discussed in backlog refinement.
Discussed setting a weekly job to check for this.
We will move to estimation, and try to get this prioritized.

KStoller-WMF set the point value for this task to 5.
KStoller-WMF moved this task from Needs Estimation to Up next Sprint on the Growth-Team board.

We discussed this during estimation. There are many areas that are not clearly defined: for example, should the thresholds have a minimum value (e.g., at least 20 days), or should any number be allowed? We also discussed whether notifications would be required. We decided to go ahead with let's get what we can now within 5 storypoints and iterate/improve later on.

It seems to me that this simple request has been dragging on for 3 years. Why is it taking so long?

  1. Add a column in Special:ManageMentors indicating whether this mentor is currently flagged as absent or not.

I like the idea, but I wonder instead of a boolean, we could make this a 'return date' column instead, with blank meaning not away. A column header 'Away<br/>until' should be self-explanatory, and we could default to dd-mm values and allow mm-dd if Preferences > Date format option 2 is selected. Year would be obvious in context if the max away period is 30 days (or even longer periods up to a year).

mentor.jpg (450×285 px, 34 KB)
I would be interested to know why mentors who have not been active at all are allocated to users. Is there no vetting process or threshold for mentors? Are they accorded the mentorship right on simple request? Who allocates the mentors? Who sets these criteria?

Would probably need specifics to investigate this (wiki, mentor username, mentee username, date this happened). Please consider providing that info if you're comfortable. Each wiki has different settings... perhaps this wiki's settings need adjusting.

@Novem Linguae. I don't think I want to enter a naming-and-shaming exercise, but the screenshot is genuine. (around March this year, en.Wiki)

Is there no vetting process or threshold for mentors? Are they accorded the mentorship right on simple request? Who allocates the mentors? Who sets these criteria?

The Mentorship system is designed to be community-configurable, which means each wiki can define its own criteria and level of oversight.

For example, on English Wikipedia, admins can set minimum requirements such as account age and edit count through the configuration page:
https://en.wikipedia.org/wiki/Special:CommunityConfiguration/Mentorship

There is also a setting that determines how mentors are enrolled. By default, editors who meet the eligibility criteria can enroll automatically. However, communities can disable this option. If they do, mentors must be explicitly added by an admin via Special:ManageMentors, allowing for a more curated or vetted process.

In practice, most wikis rely on the automatic eligibility model because it reduces admin overhead. Instead of pre-vetting all mentors, admins can remove mentors if they are not a good fit.

This task aims to reduce this ongoing manual oversight by automatically removing mentors who are inactive. It is important to note that this type of automation can address inactivity, but it cannot reliably identify or remove mentors who are ineffective, as that would be much harder (and likely problematic) to attempt to address programmatically.

. . .
This task aims to reduce this ongoing manual oversight by automatically removing mentors who are inactive. It is important to note that this type of automation can address inactivity, but it cannot reliably identify or remove mentors who are ineffective, as that would be much harder (and likely problematic) to attempt to address programmatically.

The ability to make those hard decisions still requires a discerning, human eye to assess and deal with them manually. What neither the current system nor the proposed automated system to cull mentors provides, is the ability to provide admins with the information they need about mentor status and activity in order to make those decisions when warranted.

To support admins in this role, imho we need a Mentor Status Dashboard to provide that information. See T425232.

Change #1286825 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[mediawiki/extensions/GrowthExperiments@master] refactor(Mentorship): Narrow the interface for MentorRemover

https://gerrit.wikimedia.org/r/1286825

Change #1286826 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[mediawiki/extensions/GrowthExperiments@master] Create a maintenance script to automatically clean the mentor list

https://gerrit.wikimedia.org/r/1286826

Change #1286967 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[mediawiki/extensions/GrowthExperiments@master] refactor: Move mentor status logic change to the writer

https://gerrit.wikimedia.org/r/1286967

Change #1286825 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] refactor(Mentorship): Narrow the interface for MentorRemover

https://gerrit.wikimedia.org/r/1286825

Change #1286967 abandoned by Urbanecm:

[mediawiki/extensions/GrowthExperiments@master] refactor: Move mentor status logic change to the writer

https://gerrit.wikimedia.org/r/1286967

Change #1286826 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] Create a maintenance script to automatically clean the mentor list

https://gerrit.wikimedia.org/r/1286826

Moving back to Needs Work as it awaits a second patch with new UX copy

Moving back to Needs Work as it awaits a second patch with new UX copy

I moved this to T427475. I'm repurposing this task as an Epic, given it will connect more similar tasks (that would be easier to track separately).

Urbanecm_WMF renamed this task from Provide a system to automatically suspend or remove mentors from the list of mentors to EPIC: Provide a system to automatically suspend or remove mentors from the list of mentors.Thu, May 28, 8:23 AM
Urbanecm_WMF moved this task from Inbox to Active Epics on the Growth-Team board.

For Tech News:

Mentorship is most effective when active experienced users act as mentors. To support the community's efforts in curating the mentor list, the Growth team [[mw:Help:Growth/Mentorship#Automated_mentor_list_cleanup|made it possible to remove inactive users automatically]]. Inactivity is determined by edits made (users who log in periodically, but don't edit, will be considered inactive). Administrators may enable this feature via Community configuration using the Mentorship configuration section. [https://phabricator.wikimedia.org/T321509]

For Tech News:

Mentorship is most effective when active experienced users act as mentors. To support the community's efforts in curating the mentor list, the Growth team [[mw:Help:Growth/Mentorship#Automated_mentor_list_cleanup|made it possible to remove inactive users automatically]]. Inactivity is determined by edits made (users who log in periodically, but don't edit, will be considered inactive). Administrators may enable this feature via Community configuration using the Mentorship configuration section. [https://phabricator.wikimedia.org/T321509]

@Trizek-WMF I am guessing this is not ready to be announced.

@Trizek-WMF I am guessing this is not ready to be announced.

Yes. We will check on how it works at one or two wikis first.