Page MenuHomePhabricator

Design: Mentorship (final specs for the pilot release of Home)
Closed, ResolvedPublic3 Estimated Story Points

Assigned To
Authored By
KStoller-WMF
Jul 23 2026, 9:22 PM
Referenced Files
F98748266: Arc 2026-08-16 21.27.45.png
Sun, Aug 16, 7:30 PM
F98747154: image.png
Sun, Aug 16, 7:30 PM
F98747226: image.png
Sun, Aug 16, 7:30 PM
F98747324: image.png
Sun, Aug 16, 7:30 PM
F98746611: image.png
Sun, Aug 16, 7:30 PM
F98746411: image.png
Sun, Aug 16, 7:30 PM
F98746304: image.png
Sun, Aug 16, 7:30 PM
F98746067: image.png
Sun, Aug 16, 7:30 PM

Description

Context

This task continues design work from T426702: Design prototyping: Personal Dashboard + Homepage [FY26-27, Deepen Engagement 1.3], which explored Dashboard layout paradigms, onboarding simplification, and navigation, and T420862: Early Design Ideation: Personal Dashboard + Homepage [FY26-27, Deepen Engagement 1.3] before it.

We are now moving from exploration to definition: the parent task covers the final designs and specs for the pilot wiki release of Home.
This subtask covers only the Mentorship module.

For this release we are aiming to improve second-week retention.
https://www.mediawiki.org/wiki/Contributors/Strategy

Task Objective

Produce final mobile and desktop designs and specs for the Mentorship module on Home, sufficient for engineering handoff.

The module must:

  • Be capable of fully replacing the Mentorship experience on the existing Newcomer Homepage for new accounts on pilot wikis
  • Be mobile-first: all core flows optimized for mobile, with desktop parity
  • Be designed for the new Home view, which is delivered technically via the PersonalDashboard extension.
Designs
  • Mobile and desktop layouts for the Mentorship module on Home
  • All module states: loading, populated, Opted-out of Mentorship, error(?)
  • The ask-a-question flow from the module (entry point, composition, confirmation)
UX specs & display states needing definition

Conditional display

  • What does Mentorship look like for experienced editors? Is it shown at all, and if so, in what form? Do current Mentors also see this view?
  • If the user opts out of mentorship, what remains in its place, and how do they restore it?

Content & layout edge cases

  • Long mentor usernames and long mentor intro messages: truncation behavior on small viewports
  • RTL layouts and long translated strings
Acceptance Criteria
  • Final mobile and desktop designs for Mentorship on Home
  • All module states designed
  • Ask-a-question flow documented
  • Specs documenting conditional display logic (experienced editors, opt-out), sufficient for engineering handoff

Event Timeline

KStoller-WMF triaged this task as High priority.
KStoller-WMF moved this task from Inbox to Up next Sprint on the Growth-Team board.
KStoller-WMF set the point value for this task to 3.Jul 26 2026, 10:19 PM
AAlhazwani-WMF changed the task status from Open to Stalled.Sun, Aug 16, 7:30 PM

similarly to T433019#12208238 we went through a process of "codex-ification":

  1. to start we "converted" the existing module variants to use only codex tokens and components
    image.png (1,780×1,880 px, 186 KB)
  2. then we tried to use the codex card component to display the mentor
    image.png (856×1,880 px, 120 KB)
  3. we removed borders to reduce visual noise
    image.png (856×1,880 px, 119 KB)
  4. brough the button to the main view so that it's not needed to "open" the module to ask a question to the mentor
    image.png (856×1,880 px, 119 KB)
  5. then we turned ephemeral informational text to a dismissable element (thou we're unsure if this text is really needed. from 2 usability tests, we've observed participants understanding that the system assigned them a mentor without the explanatory text)
    image.png (856×1,880 px, 129 KB)
  6. and swapped the arrow icon with a contextual menu to give immediate access to opt-out features, and info materials
    image.png (856×1,880 px, 141 KB)
  7. and finally we brought over some of the changes that we've originally suggested as part of a mentorship-related design sprint (more on T397119)
    image.png (856×1,880 px, 155 KB)

building off this process we outlined all the different variants that 'mentorships' need to support (figma file).

Arc 2026-08-16 21.27.45.png (2,902×930 px, 363 KB)

We can consider this task resolved and these designs approved.

We are aiming to move quickly and get a version of Mentorship available for the PersonalDashboard ASAP, so if engineers run into technical blockers in implementing any of these changes, let's discuss!

@AAlhazwani-WMF One piece I realised is missing from this design is "Your recent questions", which displays a list of the questions you recently asked your mentor. Is that intentionally left out here?

@AAlhazwani-WMF One piece I realised is missing from this design is "Your recent questions", which displays a list of the questions you recently asked your mentor. Is that intentionally left out here?

My understanding is this was intentionally excluded to simplify.

The downside I see is that newcomers might not understand where their question was posted, and might be slightly more likely to ask the same question again if we don't show it from within that module.

The benefit of removing it is that newcomers don't have to see that "embarrassing" question they asked previously. I know I've heard from at least one newcomer who wanted to "dismiss" or "remove" their past questions.

This feature predates me, perhaps @Trizek-WMF has a perspective about how necessary this feature is.

The "Your recent questions" section allows newcomers to find the questions back, in particular when they get archived. Talk pages are really complicated places to navigate, and finding back a past comment is very complicated, in particular when you edit Wikipedia occasionally (like the majority of users do).

So I'd not remove this element of the mentor's module even if we got one feedback in favor. Most newcomers have will never understand that they can share their feedback; if we want genuine feedback about this, let's ask them on the interface directly.