Growth/Focus on help desk

This page describes the growth>Growth|Growth team's work on the "Focus on help desk" project, and contains major assets, designs, and decisions. Most incremental updates on progress will be posted on the general growth-updates>Growth/Growth team updates|Growth team updates page, with some large or detailed updates posted here.

This is the [http://reetssydney.github.io/prototypes/help-pane-v1/index.html link to an interactive prototype] of the "helppanel>Growth/Focus on help desk/Help panel|help panel" feature we are building to support this project, described in detail on this page. Anyone can try out the actual help panel in testwiki>testwiki:Main_Page|Test Wikipedia by creating an account, turning on the help panel in their account's testwiki-pref>testwiki:Special:Preferences#mw-prefsection-editing|Preferences/Editing page, and then clicking "Edit" on any page.



Current status

 * 2019-03-26: published.
 * 2019-03-04: help panel being shown in reading context in Help, Help talk, Wikipedia, Wikipedia talk, User, and User talk namespaces.
 * 2019-02-28: help panel deployed in Vietnamese Wikipedias in an A/B test, with half of newcomers not receiving it.
 * 2019-02-14: the search capability deployed for treatment groups in Czech and Korean Wikipedias.
 * 2019-01-11: help panel deployed in Czech and Korean Wikipedias in an A/B test, with half of newcomers not receiving it. To view questions from the help panels in those wikis, see their help desks:
 * Czech help desk
 * Korean help desk


 * Next: we will deploy the help panel in Vietnamese Wikipedia in February. We are planning to make the help panel appear in more contexts, such as when newcomers view Help and Wikipedia namespace pages.  By the end of February, we will be able to publish analysis on whether the help panel increases editor activation.

Summary
It is common for new editors to face technical, conceptual, and cultural challenges when they start editing. They have specific questions, and could benefit from a human editor answering their questions. Most wikis have a help desk where new editors can ask questions, and such venues have been proven to be effective, especially the teahouse>:en:Wikipedia:Teahouse|Teahouse in English Wikipedia (see [http://www.opensym.org/wp-content/uploads/2018/07/OpenSym2018_paper_15.pdf this paper] for an analysis of impact). The problem is that most new editors don't know about or find the help desk -- even though they frequently receive "welcome templates" on their talk pages with links.

We have two hypotheses:


 * Newcomers are more likely to seek help when presented with an easy way to submit questions.
 * Newcomers are more likely to complete edits by knowing where to seek help.

Therefore, the "Focus on help desk" project contains two parts:

Once we are successful at driving new editors to the help desk, undertake improvements to the help desk itself that make it a better place to ask questions. This might include listing new questions at the top of the page or notifying new editors when their questions have been answered.
 * 1)  Invite new editors to the help desk.  We had four ideas for how to invite them: by posting on their talk pages, by using banners, through email, or by adding a link in the editing context.  We have decided to invite new editors to the help desk by adding a clear and obvious link to the help desk inside their editing experience, which we are calling the "help panel". That's for these reasons:
 * 2) * We know from the New Editor Experiences research that getting help in-context is important. This would offer a link to get help at the moment when users need it, and in a place that currently has no clear way to get help.
 * 3) * We have open questions around the "growth-ideas-chat>Growth/Discussing potential Growth ideas#In-context%20questions%20or%20chat%20(1)|In-context questions or chat" idea, and this will help us learn whether there is demand for such a feature.

The Growth team built Part 1 (the help panel) first during 2018 Q2 (October 2018 - December 2018), and deployed it in Czech and Korean Wikipedias on January 11, 2019 inside a controlled A/B test. This experiment will take until July 2019 to fully complete. As results come in, we may add additional capabilities to the feature, deploy it in additional wikis, or decide to begin Part 2 (undertaking improvements to the help desk itself).

Comparative review
Our team's designer reviewed the way that other platforms (e.g. SurveyMonkey, American Express, Codecademy) offer help in-context to their users (see this task for details). We think there are best practices we can learn from other software, especially when we see the same patterns across many different types of software. Even as we incorporate ideas from other software, we will still make sure to preserve Wikipedia's unique values of openness, clarity, and transparency. The comparisons are shown in this slide deck, and the main takeaways are:

In-context help UIs


 * In-context help is usually presented as a sticky button or tab in the bottom right of the screen
 * Clicking on help will usually open up a sticky panel over the UI offering one or more help options
 * Users are often able to search and view top help topics within the in-context help panel
 * In-context help will also link users to the dedicated/primary help center/forums
 * General/site-wide Help is usually a primary navigation option as well, and may also enable access to chat/feedback within the UI
 * Indicators of privacy and security also often shown in the expanded help UI


 * Mobile (app/web) versions typically do not have help accessible in-context but accessed as a primary navigation item that opens separately

Types of help offered in-context


 * Link to a Help Center / Help Desk
 * Top FAQs listed for that particular context
 * Live chat
 * Video/Tutorials
 * Guided tour links
 * History of previous help queries
 * Community forums - used in a couple of places where there is less expectation of immediacy in response times and level of ‘service’
 * “Report a bug” - for users to send feedback about unexpected behaviors/bugs, often with the option to include a screenshot of the UI. Implicit expectation is the user should not to expect a response.

Features of Chat/Q&A in help


 * Users are able to email questions using the chat panel when there is no “Live” agent is available
 * Users are given feedback on response time windows and where they can expect answers
 * Voice and tone of chat is friendly and personable, sometimes with emoji and gif options in chat.
 * Users likely expect a level of service, as chat is typically provided by paid customer service reps.
 * Privacy links and information about how chat history is managed is clearly shown
 * Frequently asked questions/topics common for the particular context is often presented in the same UI as an less engagement-heavy help alternative for users
 * Automated answers / “Answer bots” are sometimes offered first to try to resolve the issue before users are given the option to post their question

Review of similar Mediawiki features
As we discussed ideas for the help panel, several WMF staff reminded us that two similar-sounding features had been worked on in the past: MoodBar and Article Feedback. Those features (though no longer in use) both gave users an in-context tool for providing information, and so we think we can incorporate learnings from them. The details of this work are on this task, and the main takeaways are: Article Feedback Tool


 * Potential for account creation and editor activation - anonymous users who start an edit may be prompted to create an account when asking for help so that they can get feedback from the “Help team”.
 * Provide more upfront help options prior to allowing submission of free-text comments and questions - Per findings from the Article Feedback Tool, making it too easy to submit unstructured and out-of-context comments about articles leads to a high degree of noise for moderators. Whilst our hypothesis is that users who are in the editing context and seeking help for a specific task may be less likely to submit un-useful questions, providing more self-directed help alternatives upfront may further reduce volume.
 * Mechanisms to provide context to comments – The lack of context to comments in AFT was a main point of dissatisfaction for editors. For in-context help, it would be ideal if users submitting a question or comment would be able to denote where in the article or UI they would like assistance – for example being able to submit a screenshot along with their question, or being able to highlight the section related to their comment.
 * Making interactions into actual edits - This tool created a separate queue of work for experienced editors to deal with, that they couldn't manage through their Watchlists or RecentChanges, and current curate with existing processes for removing damaging content. It is important that any additional traffic we create can be managed through existing systems, which is done most easily if interactions with our feature are done as posts on wiki pages.

MoodBar


 * Capturing email for responses is an effective option – As shown in the MoodBar experiment, email notifications is an effective means of engaging new editors.
 * Clear, prominent call to action for new editors to ask for feedback/help - per high level findings, the addition of a tooltip drawing attention to the MoodBar significantly increased its use.
 * Tracking the perceived helpfulness of responses is important - It would be useful for us to track similar new user perceptions of feedback, since a poor experience from receiving unhelpful advice has been shown to negatively impact editing.

Design for help panel
Our evolving designs can always be found in this interactive prototype. These clickable mockups also contain other design ideas for future iterations of the help panel, although some elements in those mockups may be obsolete. To see the latest version of the help panel, edit a page in Beta or Test wiki after having turned the help panel on in your preferences.

The "Comparative review" and "Review of similar Mediawiki features" were critical in the design process because they helped us "dream big" to explore the space of what the help panel could eventually become. Our team mocked up and discussed many ideas that probably will not become part of the help panel unless we see that earlier, simpler versions are successful. First, we are going to work on an initial version of the help panel to be deployed in January 2019.

Initial version
In the initial version of the help panel, we want to answer these questions:


 * Will newcomers click on a clear option to get help during the editing experience?
 * Do newcomers seem more interested in reading content to answer their own questions, or in asking a question for others to answer?
 * Will newcomers take action to write and post a question to the help desk?
 * Will the presence of the help panel increase new editor retention?

Therefore, we have decided to include these elements in the initial version, detailed in T206717 and T209318:


 * A call to action in the editing context.
 * A panel that opens containing links to helpful existing pages.
 * The ability to ask a question from that panel, and for that question to be automatically posted to the wiki's help desk.
 * The ability to add an email address to their account if the user does not already have one, and to modify their email address if it is not yet confirmed (and then to receive a confirmation email upon submitting).
 * The ability to turn off the help panel by clicking through to Preferences.

The mockups below show initial designs for that functionality as of November 2018 (to see the most up-to-date designs, use this interactive prototype). Right now, we will show this only to newcomers (meaning new account holders who are not auto-created). We also know that the wording in the feature is very important here, because it is critical that newcomers understand where and how information they write will be posted, and when and where they can except a reply. These mockups only contain some initial drafting of the wording, and we'll continue to refine it. We are hoping for strong ideas from community members, so please post any ideas on the talk page.

Business rules for initial version
Below are the current rules we're using to determine who receives the help panel and how it works. These may change as our team and the community continues to discuss and learn from the feature.


 * Users: the help panel will be a feature that can be turned on and off in user preferences. When it is deployed in January, it will be turned on to only newly created accounts (not auto-created) from the deployment date forward (except for a control group that will not have the feature).  All other users whose accounts were created before the deployment date will have the feature turned off, but will be able to go to their preferences to turn it on if they wish to try it out.  We will also be embedding an option to turn the help panel off inside the feature.  Our team discussed the possibility of turning the help panel on for all users, but wanted to first learn about how new users interact with it, and we want to make sure not to flood help desks with incoming questions.  See this Phabricator task for the discussion.
 * Namespaces: the help panel will be available in all namespaces. Our team discussed limiting the feature to only the main article namespace because the help documentation linked in the panel is mostly relevant to that namespace.  Ultimately, we decided to make it available in all namespaces so that we can learn in which namespaces people are most commonly looking for help -- we know that new editors struggle to edit the Talk namespace.  We will also encourage communities to develop documentation relevant to editing other namespaces (particularly the Talk namespace) so that we can make those links available in the appropriate namespaces.  See this Phabricator task for the discussion.
 * Headers: the help panel will automatically post users' questions to their wiki's help desk, and will automatically generate a header for that post. We have decided that the header will include the title of the page from which the question originates (with a link), as well as a timestamp to distinguish it from questions that may have originated from that some page.  Users will be able to decline to include the title in their header, if they consider it sensitive.  See this Phabricator task for the discussion.  Our preference is to number the posts instead of including a long and redundant timestamp, but that will require additional engineering work for a future version.

Wording for initial version
The wording for the help panel is complete, and the current state can be seen in the interactive mockups. Some of the most important things we have been considering in the wording are:


 * How to make it clear that by asking a question in the help panel, users will be posting in public?
 * How to encourage users to add their email address, since that is the best way for them to find out when they get a response to their question?
 * How to give users the option of excluding the title of the page they're editing from the automatically-generated header in the help desk, if they want to keep that private?
 * How to correctly set expectations about how quickly a user can expect a help desk response?
 * What to include in the automatically-generated header in the help desk?

Future versions
In determining the initial version of the help panel, many ideas for features were set aside to be evaluated later on. Many of them are visible in the initial mockups here. The following is a list of capabilities that are either being built for the help panel, or may be built in the future:


 * Nearer term
 * ✅ Search: the ability to search help pages. Users found this option appealing during testing, and it was built in T209301 and deployed on 2019-02-14.Help panel kowiki search 2019-02-15.png
 * ✅ More contexts: since help desks have not yet been overwhelmed with incoming questions, we are thinking of exposing the help panel to newcomers in contexts beyond editing -- perhaps while they are viewing pages in the Help or Wikipedia namespaces. We thought of this because the EditorJourney analysis showed that large portions of newcomers viewed pages in those namespaces during their first 24 hours.  Currently being built in T215664.
 * Greater affordance: so far, it looks like a minority of users who see the help panel button actually open it up. We could attempt to make it more visually obvious that it is a recommended place to start.
 * Vary links with context: the help panel contains five links to help pages, and about half of users that see them click on one. Different links are probably valuable in different contexts.  For instance, there might be some links for visual editor and some for wikitext.  Or some that are helpful on a talk page and some on an article page.  This is being worked on in T211117.
 * Longer term
 * Suggested answers: many questions that users asked may have already been answered before, and we might be able to provide suggested answers as users type. This would be relevant once many more questions have been asked.  Ticketed in T209327.
 * Feedback on responses: newcomers may find the responses to their questions more or less satisfactory. By allowing newcomers to rate their responses, we may increase higher quality responses, and make it possible to surface the best ones to future newcomers.  Ticketed in T209332.
 * Marking question context: newcomers may have questions related to very specific elements of the editing experience. This idea would allow them to indicate exactly where on the page their issue is occurring.  Ticketed in T209328.
 * Templated replies: research shows us that the tone of a reply to a newcomer can make a difference in whether they edit again. We may be able to help people answering questions to format their replies in a nurturing way.  Ticketed in T209331.
 * Anonymous editors: though our team is focused on registered newcomers, it is possible to make the help panel present for anonymous editors, though it will be more difficult for them to find out that they have received a response. Ticketed in T209325.

User testing for help panel
During the week of November 26, 2018, we used usertesting.com to conduct eight tests of the help panel interactive prototype with internet users unaffiliated with the Wikimedia movement. Four tests were done on desktop and four were done on mobile. In these tests, respondents are compensated for trying out the mockups, speaking aloud on what they observe, and answering questions about the experience. As our team's designer described on the Phabricator task, the goals of this testing were:


 * 1) Gauge the discoverability of the help pane call to action and help pane
 * 2) Identify improvements to the usability of the help pane:
 * 3) * Do users understand they can edit and use help links at the same time?
 * 4) * Are users able to successfully follow the steps to post a question?
 * 5) * Is there anything users that would like to be able to do from the help pane that they are missing?
 * 6) Gauge user reactions to the help pane and expectations of how their questions will be answered.

Summary of findings


 * All users found the help panel contents to be very useful in getting help for editing.
 * No one had issues with having the article title included in the question.
 * Most participants would post a question to the help desk as a last resort after trying to help themselves through clicking on links, with two people saying they would likely not post at all as they would want a more immediate response.
 * One user said they would more likely just Google the editing help over the options shown.
 * Whilst it was understood that the Help desk would be answered by volunteers, many participants wanted more reiteration and clarity of expected wait times.
 * Clear layout of options, shown in the order in which almost participants said they would seek for help.
 * Discoverability of the help panel call-to-action may be reduced in the case when the user is using the Visual Editor or wikitext2017 editor because those editors have a competing “?” icon.
 * One user suggested having an example question in hint text.
 * One user wanted more information shown about when their question was viewed and by how many people.
 * Two users mentioned the help recommendations shown on the Help Desk seemed disjointed from what was shown in the help panel.

Recommendations (not all of these will be implemented)


 * Prioritize the Searching help task inside the help panel.
 * Provide clearer times on both the review and confirmation screens for when a newcomer should expect a response from the help desk.
 * Add a more specific help question sample in the placeholder/hint text.
 * Experiment or A/B test alternative text on the initial “Ask a question” call-to-action.
 * Show a first-run tooltip/pulse indicator to highlight the new help panel.
 * Add an additional menu item to existing editing toolbar help on Desktop VE or Wikitext2017 which opens the help panel.

Measurement and experiment plans
High-level questions

These are the main things we want to find out from the help panel.


 * 1) Does the presence of the help panel lead to questions being asked and answered?
 * 2) Does the presence of the help panel increase editor activation (making their first edit)?
 * 3) Does the presence of the help panel increase editor retention (coming back to edit again)?
 * 4) Does the presence of the help panel increase the proportion of constructive edits?

Controlled experiments

See this page for the detailed experiment plan.

In order to understand the help panel’s impact on editor activation and retention, we propose a six month A/B test. During that test, 50% of new registrations on target wikis will have the help panel enabled by default, and 50% will have it disabled. We anticipate that we will be able to detect 10% changes in activation after about one month, and 10% changes in retention after about six months. We are likely to be running other experiments on the target wikis at the same time, for example, testing variants of our welcome survey. Therefore, assignment of users to treatment and control groups for all tests will have to be coordinated so that we ensure the distributions are not biased.

Specific measurements: quantitative

''These are specific measurements that help us answer the high-level questions. These are measurements we will be able to do programmatically. See this EventLogging schema for the exact details on the data that is being recorded and stored.''


 * 1) What is the context the user is in when they start interacting with the help panel?
 * 2) What percent of users open the help panel?
 * 3) What percent close the help panel without using any part of it?
 * 4) What percent click one or more of the help links?
 * 5) How far do users go in the workflow of asking a question?
 * 6) What percent of users turn the help panel off?
 * 7) What is the average length of questions asked via the help panel?
 * 8) What percent of users click any of the links in the final confirmation page of asking a question?
 * 9) What percent of users who post a question return to view the answer?
 * 10) Does interacting with the help panel alter the probability of abandoning an edit session?
 * 11) What percent of users use the help panel more than once?
 * 12) Are newly registered users with an email address likely to return to view the answer to their question?
 * 13) What percent of newcomers that had no email address add one when asking a question?
 * 14) What percent of newcomers confirm their email address (within 48 hours) after asking a question?
 * 15) What percent of newcomers ask a question without an email address?
 * 16) What percent of newcomers submit a question without including the title of the page they were editing?
 * 17) How does help panel usage vary with welcome survey responses?

Specific measurements: qualitative

''These are specific measurements that help us answer the high-level questions. These are measurements we will need to do manually, by counting and reading the contents of help desks. Doing these programmatically would be an inordinate amount of work.''


 * 1) What percent of questions get answered?
 * 2) How quickly do questions get answered?
 * 3) How often do newcomers edit the question they asked?
 * 4) What kind of questions do people ask and which ones are more likely to get answered?

Usage counts
After about two months of being deployed to half of new accounts in Czech and Korean Wikipedias, and two weeks of being deployed to half of new accounts in Vietnamese Wikipedia, these are the numbers (as of 2019-03-28):


 * 3,343 users have seen the help panel button
 * 566 users have opened up the panel
 * 225 users have clicked a link in the panel
 * 51 have run searches
 * 51 users have submitted a question to the help desk (Czech: 34, Korean: 8, Vietnamese: 9)

Leading indicators
The help panel's experiment plan defines a set of leading indicators that the team evaluates in order to determine whether the feature is behaving as expected, and whether there are any urgent problems that need to be solved.

Using a month of data, we published an initial evaluation of leading indicators here. In summary, the help panel seems to be behaving in a healthy way, with good numbers of newcomers opening and using it. The analysis identified a couple areas for improvement that the team has taken action on:


 * Because we wanted to increase the number of newcomers who open the panel, we started showing it in additional contexts on March 4, 2019. Newcomers now see the help panel when reading in the Wikipedia, Help, and User namespaces.
 * Because we saw that in Korean Wikipedia very few users ask questions, we built the search feature so that newcomers would have an easier way to find helpful information on their own.

Resources

 * More on this feature: The help panel contains a link to learn "More about this feature". That link will lead to this page, which will hopefully answer user questions about how the feature works.  Feel free to translate it into your language!
 * Best practices: Because many communities don't have a lot of experience concerning help desks, the WMF Community Relations Team has assembled on a page with some best practices that can help communities have more successful collaborations with newcomers. Please feel free to translate that page into your language!