Page MenuHomePhabricator

Mentor dashboard: M1 mentee overview module
Open, Needs TriagePublic

Description

This is a task for building one of the modules in the mentor dashboard: an overview of the mentees.

Main audience: Experienced editors who signed up to their wikis mentor list.

Figma mockups: mockup M1 desktop

Goal/rationale: The main objective of the module is for the mentors to have the ability to watch the progress of their mentees, be aware of any setbacks, and filter through their mentee's data. This could allow mentors to be more proactive with their mentoring. This module can be seen as the main component of the dashboard that contains a table with the data of each mentors’ mentees. The table holds a variety of data points for each mentee that includes: username, recent activity, reverted edits, blocks, questions asked total edits, and tenure.
The mentor will be able to sort each of the values (apart from the mentee's usernames, which will be sorted according to their recent activity) from highest to lowest. Additionally, there will be a filter that can filter out the mentees according to the number of edits and/or a specific time period.

General

  • Rules for the table: Mentees + data disappears off of the table if and only if, they have created their account 2 weeks ago and have made 0 edits. Or if they have not made an edit in the last 6 months.
    • They pop in the minute they make an edit
    • If there are more than 1000 mentees in the list sort by contributions (take those off the list with the least edits)
    • Exclude bots from the list
    • Exclude people who have been indefinitely blocked
    • Allows experienced editors with over 5000 edits to test the dashboard but their info. (edit, reverts, block, etc.) is excluded from their assigned mentor's mentee list/ impact module.

The specifications are written out below.

Copy and links

  • Title: "Your mentees"
  • Icon (across from title): info icon (see “info icon” for more details)
  • Subtitle: "The table showcases the state and progress of your current mentees. Personalize the table through filters to view specific results."
  • Next: “Add filter” dropdown button (see “add filter” for details)
  • Next: Search bar
  • Next: a table that displays the information about the mentees (see “mentee table” for content)
  • Next: a link dropdown “Show [value] ” that indicates the number of rows the table will display in the module. Initially set the default number of rows to 8. Other options for the number of rows shown in the table include 5-10, 15, 20.
  • Next: range of values that indicate how many mentees you are seeing out of the total number “[value1] – [value2] of [total]” eg. 1-8 of 21.
  • Next: arrows (backward and forward) allowing to flip through the table.

“Info icon”

  • When users click on the icon a pop-up button widget shows up with the set of rules applied to the table.
  • Title: Who is displayed in your table? working title
  • Text: Weekly, you get hundreds of newcomers assigned to you but not every newcomer is interested in editing Wikipedia. Your table won’t display newcomers who 1) haven’t made an edit in their first two weeks after registering, 2) haven’t edited in over 6 months. However, the minute your mentee makes a new edit they will reappear in the table.

“Add filter”

  • If the mentor clicks on the “add filter” dropdown button they will be able to filter the table by # of edits or a specific time period and ability to choose to see starred mentees. None of the filters are active at default.
  • Header: “See mentees with total edits”
  • Next: “From” followed by an input box (values have to be equal to or greater than 0) and then an “Up to” followed by an input box (value has to be equal to or greater than 0, or greater than the value in the “from” input box).
  • Header: “Search time period”
  • Next: two separate subheaders "Recent days" "Recent months"
  • Next: Text inputs: 3 options under “Recent days” which included “1”, “7", “14 and 2 text inputs under “Recent moths” which included “1” and “3”.
  • Header: “Starred mentees”
  • Next: Checkbox beside which you have “Only show starred mentees”.

“Mentee table”

  • General: The table has 7 columns and shows a default of 8 rows. The table includes the mentee's username, recent activity, reverted edits, blocks, questions asked, total edits, and tenure.
  • 1st column:
    • Header: none.
    • Next: Each row proceeding the first row has a hollow (inactive) star icon. With this icon, the mentor can favorite/watch the progress of a specific mentee. When the mentor click/taps on the icon beside a specific mentee username the start becomes filled (active).
  • 2nd column
    • Header: A user avatar icon, beside which you have up & down arrows to sort the column by most/least recently active mentees.
    • Next: Each row in the column will have the mentees username under which it will show the last time the mentee has been active. When the username is tapped/clicked the mentees user page will open up in a new tab.
  • 3rd column
    • Header: an edit undo icon beside which you have up & down arrows to sort the column by most reverts/least reverts.
    • Next: Value represents the number of reverts for each mentee in the same row.
  • 4th column
    • Header: a block icon beside which you have up & down arrows to sort the column by most/least blocks
    • Next: Value represents the number of times the mentee has received a block on their account.
  • 5th column
    • Header: a help (question mark) icon beside which you have up & down arrows to sort the column by most/least number of questions.
    • Next: Value represents the number of times the mentee has asked their mentor a question.
  • 6th column
    • Header: an edit icon beside which you have up & down arrows to sort the column by most/least edits.
    • Next: Value represents the total number of contributions for each mentee.
  • 7th column
    • Header: a clock icon beside which you have up & down arrows to sort the column by most/least time on wiki.
    • Next: Each row in the column will display the total time the mentee has had their account. The units will be abbreviated (wks, mths, yrs).

Future: a list of capabilities that may be needed in future versions

  • Could add more columns to the mentee table, eg. created pages.

might be moved to another ticket

Mobile

Copy and links

  • Everything stays the same for mobile except:
    • The page does not have a subtitle text explaining what the table is about.

Related Objects

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

Hello, thanks for creating the task @OTichonova! I have a few of questions:

  • Do I understand the specs right that we aren't going to show any mentees with no edits?
  • Will the business rules for mentees (do not care about mentees who are registered for 2 weeks or more and still have no edits, and don't care about mentees who didn't edit for 6 months) transfer to other modules in the dashboard (like to the impact module)? In another words, is it a part of M1 spec, or dashboard spec?

@OTichonova A follow-up question: Does "question asked" include both mentorship and help panel questions? Help panel is not actively propagated anymore, but since we'll allow communities to configure it soon, it's possible it will be used (again).

@Urbanecm_WMF Hi, I would exclude the help panel questions. Does that sound fine for you?

@Urbanecm_WMF Hi, I would exclude the help panel questions. Does that sound fine for you?

Absolutely, thanks for the clarification.

@OTichonova A follow-up question: Does "question asked" include both mentorship and help panel questions? Help panel is not actively propagated anymore, but since we'll allow communities to configure it soon, it's possible it will be used (again).

@Urbanecm_WMF -- I think you're talking about help desk questions, not help panel questions. We do want the mentee overview to count all questions to mentors, whether they came from homepage or help panel. But we do not want it to count help desk questions. Right?

@OTichonova A follow-up question: Does "question asked" include both mentorship and help panel questions? Help panel is not actively propagated anymore, but since we'll allow communities to configure it soon, it's possible it will be used (again).

@Urbanecm_WMF -- I think you're talking about help desk questions, not help panel questions. We do want the mentee overview to count all questions to mentors, whether they came from homepage or help panel. But we do not want it to count help desk questions. Right?

Yes, of course. Sorry for my typo :).

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

[mediawiki/extensions/GrowthExperiments@master] WIP: Add ApiQueryMenteeOverview to access data about mentees

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

Hey! I am very sorry for having connected again with such a delay :(

Allows experienced editors with over 5000 edits to test the dashboard but their info. (edit, reverts, block, etc.) is excluded from their assigned mentor's mentee list/ impact module.

Maybe reduce the number of edits? to 500 or 1000?