Page MenuHomePhabricator

Revise VE's GettingStarted
Open, Needs TriagePublic


This task is about revising the VisualEditor's GettingStarted "program" to ensure it equips new editors with the understanding(s) they need to successfully contribute to a Wikipedia article.


Upon landing in VisualEditor, people are shown seven dialogs as part of the GettingStarted program shown below.

While potentially effective at introducing newcomers to the different parts of the editing experience, we wonder the extent to which they fit together into a cogent experience. To demonstrate what we mean, consider how upon landing inside editing mode ("Step 4") people are introduced to the concept of previewing changes before being introduced to the tools (adding citations in "Step 6" and adding links in "Step 7") they'll need to be familiar with to make said changes.

Step 1Step 2Step 3Step 4Step 5Step 6Step 7
Screen Shot 2020-09-16 at 6.16.34 PM.png (1×1 px, 1 MB)
Screen Shot 2020-09-16 at 6.16.40 PM.png (1×1 px, 2 MB)
Screen Shot 2020-09-16 at 6.16.45 PM.png (1×1 px, 1 MB)
Screen Shot 2020-09-16 at 6.03.48 PM.png (1×1 px, 1 MB)
Screen Shot 2020-09-16 at 6.03.57 PM.png (1×1 px, 1 MB)
Screen Shot 2020-09-16 at 6.04.06 PM.png (1×1 px, 1 MB)
Screen Shot 2020-09-16 at 6.04.11 PM.png (1×1 px, 1 MB)

You can see the steps below in motion here: .

Open questions

  • How do newcomers experience the existing GettingStarted experience? E.g.: What – if any – concepts does it clarify for them? What confusion might it create?
  • What "social" and "technical" concepts are important for newcomers to walk away from this experience understanding?
  • How can get onboarding experience be implemented to increase the rate at which newcomers reach those understandings?

Event Timeline

@ppelberg - I think the cause of the confusing order (and T189569) is that most of those dialogs are created by the GettingStarted extension, step 6 is created by the Citoid extension, step 7 is created by VisualEditor, and no one ever evaluated the interplay between them all (AFAIK). Since no one is maintaining GettingStarted, I personally favor decomissioning it entirely (T235752).