Page MenuHomePhabricator

Design Task: Improving Understanding and Impact of Mentorship
Open, In Progress, HighPublic

Assigned To
Authored By
KStoller-WMF
Jun 17 2025, 5:10 AM
Referenced Files
F63746341: image.png
Thu, Jul 10, 10:30 AM
F63746326: image.png
Thu, Jul 10, 10:30 AM
F63745948: image.png
Thu, Jul 10, 10:30 AM
F63745940: image.png
Thu, Jul 10, 10:30 AM
F63745661: image.png
Thu, Jul 10, 10:30 AM
F63745552: image.png
Thu, Jul 10, 10:30 AM
F62764153: image.png
Tue, Jul 1, 1:22 PM
F62764149: image.png
Tue, Jul 1, 1:22 PM

Description

User story & summary:

As a new account holder, I want to understand who my mentor is and what they can help me with so that I can feel more confident reaching out and get help editing Wikipedia.

As a mentor, I want newcomers to understand they are contacting a real person so that the messages I receive are more relevant, thoughtful, and easier to respond to.

Background & research:

This task is important because early interactions with mentors are a key opportunity to improve newcomer retention and satisfaction. While the Mentorship feature connects newcomers with experienced editors, current UI implementations may not clearly communicate who the mentor is or what role they serve.

Recent feedback and observations suggest that many newcomers do not fully understand the purpose of the Mentorship module, and some seem to think they are posting questions to a help bot. Improvements to clarity and trust could lead to better engagement.

Example questions from new account holders who confuse Mentorship tools as AI or a help bot.

Related ideas include:

Design:
Acceptance Criteria:

Given the current Mentorship features,
What are some low-effort improvements we should consider to help make the feature easier for newcomers to understand, and ultimately improve the impact of this set of features?

Bonus: What are some bigger ideas we should consider exploring in the future?

Event Timeline

AAlhazwani-WMF changed the task status from Open to In Progress.Mon, Jun 30, 11:05 AM
AAlhazwani-WMF claimed this task.

sharing a first round of ideas. before diving into bigger ideas, we focused on small, but incremental improvements.


before changing anything, we look at the current mobile UI (but this applies to desktop too)

image.png (1×756 px, 269 KB)
image.png (1×750 px, 263 KB)
image.png (1×750 px, 223 KB)

and we tried to understand: is there anything that could be removed so that newcomers are presented with less, but more intentional text/copy?

looking at the second screen, we wondered if it's necessary to repeat "We've assigned you [...]" as second time given that it's displayed in the first screen. moreover the link "Learn more about mentors" can also be reached via the ellipses menu.

we then looked at the number of edits, and for a newcomer if might be hard to understand if a certain number is a lots of edits.

lastly, we look at the "View your mentor's other conversations", and we think it's not necessary at this point in the experience to redirect newcomers to the mentor's talk page.

we're also suggesting to simplify the amount of copy because after looking at Special:ManageMentors we've observed that mentors' message for newcomers tends to be longer than the fallback/placeholder.


we then moved over the avatar. the current design might feel anonymous to some newcomers, and we wondered if there's anything else that we could programmatically generate to echo existing patterns outside the wiki world. we looked at text messaging apps and social networks, and when an avatar/photo is not provided they default to the first letter of the (user)name.

if we keep thinking about text messaging apps, another possible copy edit is changing the language from "Active ..." to "Last seen ..."


if we put all those suggestions together here's how it would look and feel

platformcurrentdesign proposal
newcomer homepage (mobile)
image.png (1×756 px, 269 KB)
image.png (1×750 px, 247 KB)
mentor panel open (mobile)
image.png (1×750 px, 263 KB)
image.png (1×750 px, 164 KB)
help panel (mobile)
image.png (1×750 px, 223 KB)
image.png (1×750 px, 206 KB)
newcomer homepage (dekstop)
image.png (1×1 px, 116 KB)
image.png (1×1 px, 99 KB)

and finally here's a test with real content from real mentors

image.png (1×750 px, 180 KB)
image.png (1×750 px, 192 KB)

note to self: when mentors specify a personal message for newcomers, the system adds opening, and closing quotes. consider if those are needed of the blockquote styling treatment is enough.

Notes from the past Ambassadors meeting, based on the very last designs.

This is more intuitive steps to follow. “Editing since” is a good step in the right direction.

People don’t read everything, so we know that they will still have questions for an AI, but it will help.

Suggestion: add a "status" template to the page so that the newcomer will see that their question is pending a response. This could require a preview of what will be posted on the talk page.

Are there improvements we could make to how mentors preview the way their message shows up so that they're less likely to include redundant info in it?

while we work on addressing the suggestions above, specifically on how might we improve how mentors preview their message for mentees, here is the final proposal for mentees-related improvements.


mentorship module on newcomer homepage

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

what's changed?
remove

  • “We’ve assigned you...” text
  • Avatar with shield icon

add

  • Avatar with initial
  • “Editing since {YEAR OF FIRST EDIT}” text
  • “This experienced user...” blockquote

edit

  • Set username to font-weight-bold

mentorship dialog

currentnew
image.png (1×750 px, 260 KB)
image.png (1×750 px, 172 KB)

what's changed?
remove

  • “Learn more...” link
  • Avatar with shield icon
  • “25,897 edits” text
  • “Active...” text
  • “View your mentor’s...” link

add

  • Avatar with initial
  • “Editing since {YEAR OF FIRST EDIT}” text
  • “This experienced user...” blockquote

edit

  • Set {USERNAME} to font-weight-bold
  • Layout: spacing and alignment
  • Set “We’ve assigned you...” text to color-subtle and font-size-x-small

help panel

currentnew
image.png (1×750 px, 220 KB)
image.png (1×750 px, 232 KB)

what's changed?
remove

  • Avatar with shield icon
  • “25,897 edits” text
  • “Active...” text
  • ? icon from “General editing help”

add

  • Avatar with initial
  • “Editing since {YEAR OF FIRST EDIT}” text

edit

  • Set {USERNAME} to font-weight-bold
NOTE: please refer to the figma file for all the variants, desktop versions, and detailed specs on layout and spacing.