Page MenuHomePhabricator

Newcomer tasks: develop standard help content to guide newcomers
Open, NormalPublic

Description

The newcomer tasks flow asks users to open an article and then to complete an edit. With its first version, it will ask newcomers to do one of these things:

  • Copyedit
  • Add links
  • Add references
  • Update article
  • Expand article
  • Create a new article (not offered proactively)
  • Add an image (not offered proactively)

To do any of those things well, newcomers need an explanation of what that task is and how to accomplish it. The main delivery mechanism for that explanation will be the help panel, which will open up and guide newcomers while they are editing the suggested article. But newcomers will need to follow links to more in-depth content around the task. They may also want to read about what a task is before they select it. Therefore, we want to have help pages on their wikis.

There are challenges to overcome:

  • Our target wikis usually do not have help pages that explain the task to be done, or don't have pages that explain them in Visual Editor.
  • Pages that exist can be inconsistent, too long, out-of-date, or confusing.

In deploying V1.0, we include help links to "Learn more" in the "task explanation widget", but as can be seen in this task, our target wikis don't cover most cases.

We want to develop a central, standardized set of help pages for the seven tasks listed above, and then translate them to our target languages.

Timing:

  • To be used with V1.2 around the end of January 2020.

Needs:

  • One good page for each of the task types above.
  • Extract a summary from each to include in the help panel; a few sentences or bullet points.

Ideas:

  • Could do a comparative review of how other software systems organize and lay out their help pages.
  • The pages can contain a standard outline across all of them, so that newcomers know what to expect each time they open one. Some potential standard elements of the page:
    • What is this task?
    • Why is it valuable to do?
    • How long should it take? How difficult it is?
    • What are the main rules? e.g. “only link the first occurrence of the word”
    • How to technically do it in visual editor?
    • Prerequisites to have to finish the task?
    • What does an example look like?
  • Page should be concise and not too long.

Open questions:

  • Need different pages for mobile? Also, mobile VE is not the default?
  • Does each wiki need the pages to be customized in terms of content?
  • How will we deal with screenshots in different wikis? What about when they get out of date?
  • Should we include gifs or videos? How to make them in different languages?

Resources

Details

Due Date
Jan 31 2020, 8:00 AM

Event Timeline

Trizek-WMF triaged this task as Normal priority.Dec 13 2018, 10:06 AM
Trizek-WMF moved this task from Inbox to Q2 2019-20 on the Growth-Team board.
Elitre added a subscriber: Elitre.Jan 11 2019, 3:36 PM

(Trizek's part TBE in T213547.)

Trizek-WMF updated the task description. (Show Details)Jan 18 2019, 3:06 PM
Trizek-WMF updated the task description. (Show Details)Jan 18 2019, 5:08 PM
Bencemac removed a subscriber: Bencemac.Jan 18 2019, 5:16 PM

The last Growth newsletter includes an invite for collecting feedback.

Quiddity updated the task description. (Show Details)Feb 25 2019, 7:16 PM
Quiddity updated the task description. (Show Details)
Quiddity updated the task description. (Show Details)

We are moving this to Q4 for now, because @Trizek-WMF has other priorities around Talk Pages Consultation and getting additional wikis to be part of Growth work.

Restricted Application added a subscriber: Liuxinyu970226. · View Herald TranscriptMar 20 2019, 6:19 PM
Trizek-WMF lowered the priority of this task from Normal to Low.Mar 20 2019, 6:20 PM

Lowering priority since I'm not going to work on it soon.

Elitre added a comment.Jul 8 2019, 3:40 PM

Is there a plan in place for this task?

Is there a plan in place for this task?

Yes! Now that TPC is almost done, I can consider to work on it. I'll discuss about the direction of it with @MMiller_WMF soon.

Trizek-WMF changed the task status from Open to Stalled.Oct 2 2019, 10:35 AM
Trizek-WMF removed Trizek-WMF as the assignee of this task.

We don't have any plans for this project for now. It is not abandoned though, since Growth is also working on providing in-context help that would need or automatically influence this project.

MMiller_WMF renamed this task from Help panel: develop a way to guide wikis on generating the right help content to Newcomer tasks: develop standard help content to guide newcomers.Wed, Nov 13, 8:05 PM
MMiller_WMF assigned this task to Trizek-WMF.
MMiller_WMF updated the task description. (Show Details)

This is in Ready for Development because @Trizek-WMF is going to start working on it.

MMiller_WMF changed the task status from Stalled to Open.Wed, Nov 13, 8:06 PM
Trizek-WMF raised the priority of this task from Low to High.Wed, Nov 13, 8:09 PM
MMiller_WMF set Due Date to Jan 31 2020, 8:00 AM.Thu, Nov 14, 9:53 PM

Got a meeting today with @RHo who gave me some useful feedback and offered to review my review of existing solutions next week. So next step is due on Nov. 28.

Trizek-WMF lowered the priority of this task from High to Normal.Wed, Nov 20, 7:33 PM