Page MenuHomePhabricator

Provide best practices concerning writing help pages on wikis
Open, Stalled, MediumPublic


The newcomer tasks flow asks users to open an article and then to complete an edit. This requires good help contents.

This task is about writing best practices for communities, so that they can improve their help contents.

These best practices should be separated as it follows, so that communities can focus on each step without the need of rely on dependencies, like technical issues:

  • writing the content itself
  • structuring the contents
  • improving the design for contents (may require additional CSS/JS)

This work is based on T238784: Make a comparative review of help contents. The help page is

Event Timeline

Trizek-WMF updated the task description. (Show Details)Dec 16 2019, 5:20 PM

It is possible to have nice things that I would have thought impossible to have, like:

Solved for tabs!

I'll explore feedback loops for Help when I'm back.

Trizek-WMF lowered the priority of this task from High to Medium.Mar 4 2020, 7:39 PM

Lowering priority since Marshall is taking time to have a look at the current work. Blockers have been listed on T240233: Apply best practices to a subset of pages on Growth target wikis.

Trizek-WMF changed the task status from Open to Stalled.Apr 20 2020, 2:53 PM

This task is waiting for review. Stalled until further notice.