Offer new users of VisualEditor a short guided tour
Closed, DuplicatePublic40 Story Points

Description

Guided tour will show new users common tasks, explain what they are and how to find them.
Toolbar, links, cite, media, and saving.

Task T89072

KHammerstein updated the task description. (Show Details)
KHammerstein raised the priority of this task from to Needs Triage.
KHammerstein added a subscriber: KHammerstein.
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptFeb 10 2015, 2:58 AM
Jdforrester-WMF triaged this task as High priority.Feb 11 2015, 5:49 PM
Jdforrester-WMF set Security to None.
Jdforrester-WMF moved this task from To Triage to TR6: Visual diffs on the VisualEditor board.

We are not accepting this as a critical issue right now, but we will consider having a pre-release stage of development that focuses on UX polish and first experience blockers, and will consider a guided tour (along with alternatives) in that context. To be discussed further with UX.

TheDJ awarded a token.Feb 12 2015, 6:36 PM
TheDJ added a subscriber: TheDJ.Feb 17 2015, 7:41 AM

I think we should really take another look at the 'on boarding' ui, because 2 edit buttons is just 'weird'. If we keep that, we should explain it to users who have never seen two edit buttons yet.. Either with a Getting Started tour, or something similar if people feel like building tour system 2.0

Mattflaschen-WMF renamed this task from Create a guided tour for VisualEditor using Getting Started tooltips to Create a guided tour for VisualEditor using GuidedTour guiders.Feb 19 2015, 11:11 PM
Mattflaschen-WMF edited a custom field.
Mattflaschen-WMF added a subscriber: Mattflaschen-WMF.

Just a note, GuidedTour is the general framework for this, not GettingStarted.

I think this would be useful, though.

Not sure why it says "removed Story Points"; I don't even see a blank Story Points field when I edit the task.

Heather added a subscriber: Heather.Mar 1 2015, 9:22 PM
Jaredzimmerman-WMF moved this task from Triaged to For Review on the Design board.
Restricted Application added a project: Notice. · View Herald TranscriptMar 30 2015, 11:29 PM
gpaumier moved this task from Backlog to Triaged on the Notice board.
gpaumier moved this task from Triaged to Archive on the Notice board.Apr 9 2015, 5:45 PM

Please keep Communications in the loop when the copy and messaging is being created. Thanks!

For information: @Mattflaschen spent a long time (weeks, from what I'm told) trying to make GuidedTour work with VisualEditor and found them fundamentally incompatible. So there are significant technical challenges standing in the way of this project.

Neil_P._Quinn_WMF renamed this task from Create a guided tour for VisualEditor using GuidedTour guiders to Offer new users of VisualEditor a short guided tour.Jun 5 2015, 1:32 AM
Neil_P._Quinn_WMF removed KHammerstein as the assignee of this task.

For information: @Mattflaschen spent a long time (weeks, from what I'm told) trying to make GuidedTour work with VisualEditor and found them fundamentally incompatible.

I think this is some kind of misunderstanding. GuidedTour is not perfect, but it is not "fundamentally incompatible", and that is not exactly what that time was spent on.

I spent a little time tonight and prototyped the tour (using the mocks above) on Beta. Code at http://en.wikipedia.beta.wmflabs.org/w/index.php?title=MediaWiki:Guidedtour-tour-veprototype.js (note, GuidedTour has full i18n support for extension tours; just can't do it for on-wiki tours). Basically, everything is there except for the images, which can be done too.


GuidedTour was rewritten specifically to support non-linear use cases like VE, and there are already simple VE tours (oriented towards basic editing and GettingStarted, rather than oriented towards touring VE) in production. Go to https://en.wikipedia.org/wiki/Earth?tour=firsteditve when logged in with an auto-confirmed account, and VE enabled. After you see the initial prompt, follow that. Then, in VE, start making a change (e.g. type something into a paragraph), then you'll see the save step.

Note the non-linear tour work was partly based on the idea that we might want to let users walk from dialog to dialog while keeping the tour going. The tour speced above is simpler and does not use that kind of functionality, but the new API handles it fine too.

GuidedTour already has support for listening to mw.hook firings (which we already use for VE tours). It could be extended to support EventEmitter firings as well if needed.

I don't know if this is the way the VE team would go (e.g. GuidedTour does not yet use OOjs UI since it was based on another library). It's also true that no one has been working on GuidedTour in a while, and there's some technical debt; that doesn't mean the code's disappeared or doesn't work, though.

The reason there's no elaborate VE tour is just that we (both the Growth team and VE team) never prioritized that after the non-linear tour framework was done.

@Mattflaschen: Sorry for the misunderstanding, and thank you so much for the correction and the prototype! It looks what we want is totally achievable with GuidedTour in its current state. I'll start iterating on the prototype and figuring out how it fits into T101481.

Great. I assigned this to you, but feel free to ping me here or on IRC if you or anyone on the VE team have questions.

Jdforrester-WMF moved this task from June 2015 to July 2015 on the Roadmap board.Jun 11 2015, 4:05 PM
Jdforrester-WMF moved this task from July 2015 to Not soon on the Roadmap board.Jun 18 2015, 1:39 AM
Pine added a subscriber: Pine.Jun 20 2015, 8:34 AM
Pine added a comment.EditedJul 2 2015, 10:04 PM

Please do keep this good idea updated. I may integrate this into my VE training video, or remove some planned content from the script if it will be covered by the tour.

Neil_P._Quinn_WMF removed Neil_P._Quinn_WMF as the assignee of this task.Aug 3 2015, 7:43 PM