Page MenuHomePhabricator

Have a tour to introduce the new Interface
Closed, ResolvedPublic5 Estimated Story Points

Assigned To
Authored By
Hanna_Petruschat_WMDE
Jan 16 2018, 1:40 PM
Referenced Files
F13633800: Graphic-Tutorial-3x.png
Feb 12 2018, 11:07 AM
F13633616: Graphic-Tutorial.png
Feb 12 2018, 11:07 AM
F13377928: Bildschirmfoto 2018-02-09 um 14.02.22.png
Feb 9 2018, 1:11 PM
F13378026: Bildschirmfoto 2018-02-09 um 14.05.40.png
Feb 9 2018, 1:11 PM
F13377983: Bildschirmfoto 2018-02-09 um 14.02.15.png
Feb 9 2018, 1:11 PM
F13375443: Screen Shot 2018-02-09 at 13.43.00.png
Feb 9 2018, 12:46 PM
F13375446: Screen Shot 2018-02-09 at 13.43.06.png
Feb 9 2018, 12:46 PM
F12613311: MVP 1.3-tut--de-1.jpg
Jan 17 2018, 1:06 PM

Description

Problem
We used a tour for the beta version to explain the interface. This helped just to some degree. Some things were forgotten when the actual task/decision to make came up.

Solution
From a UX perspective it is recommended to guide through the actual site layout and let the make decisions and undestand the interface step by step. Therefore we set up a tour.

  1. It should be definitely clear the user is in an edit conflict and not some kind of preview. Therefore we show an overlay explaining the situation. The window can be hidden for future edit conflicts.

MVP 1.3-tut-1.jpg (1×1 px, 996 KB)

  1. We highlight interactive/decision spots step by step. The chosen pattern builds on the current behaviour of the Visual editor.

MVP 1.3-tut.jpg (1×1 px, 1 MB)

We still have a question mark/help icon in the upper right corner to review the tutorial. This should start everything over again, beginning with the slide.

NB: For the prototype, we do not need the "don't show this info again" button. Always show the tour

Event Timeline

Lea_WMDE set the point value for this task to 8.

\\Please note, that there is no more step-by-step guidance on top of the site as it was shown in earlier drafts. Please remove them, should they be still in there.//

English

MVP 1.3-tut-1.jpg (1×1 px, 987 KB)

For copy and paste purposes, also including corrected typos and stuff
Solve edit conflicts
You happen to experience an edit conflict: During your edit another user also edited the page and saved it. Your version now does not include the latest edits. We are kindly asking you to merge your version with the now latest version of the other user.
Start Merging

MVP 1.3-tut-2.jpg (1×1 px, 1 MB)

For copy and paste purposes, also including corrected typos and stuff
Conflicting versions
In the two columns you can find the conflicting version of the other user (in yellow on the left side) and of yours (in blue on the right side).
Grey boxes show paragraphs without any changes. These can be expanded or collapsed if needed.
Oka, got it.

Highlighted text
The changed text is highlighted in each version. After editing the text, the highlight will be gone.
Okay, got it.

Choose a base version
To merge both versions, first select a version to work in using the buttons in the middle of the paragraphs. The chosen version will be editable, when clicking on the pen. You can copy text from the unchosen version and paste it into the chosen version by using the copy-and-paste-function on your keyboard or on right click.
You need to select one version for each changed paragraph in order to be able to save the merged version.
Okay, got it.

German

MVP 1.3-tut--de-1.jpg (1×1 px, 1 MB)

For copy and paste purposes, also including corrected typos and stuff
Bearbeitungskonflikte lösen
Du bist in einem Bearbeitungskonflikt gelandet: Während du den Artikel editiert hast, hat eine andere Person ebenfalls editiert und schon gespeichert. Deine Version der Seite kann noch nicht gespeichert werden, da sie die neuen Änderungen noch nicht berücksichtigt. Auf dieser Seite kannst du die andere Version mit deiner Version zusammenführen.
Zusammenführung beginnen

MVP 1.3-tut--de-2.jpg (1×1 px, 1 MB)

For copy and paste purposes, also including corrected typos and stuff
Kollidierende Versionen
Die zwei Spalten zeigen den Bearbeitungskonflikt zwischen der anderen Person (in gelb auf der linken Seite) und dir (in blau auf der rechten Seite) an.
Graue Boxen enthalten Absätze, in denen keine Änderungen vorgenommen wurden. Die Absätze können nach Bedarf ein- oder ausgeklappt werden.
Okay, verstanden.

Markierter Text
Die Textstellen, die in den jeweiligen Paragraphen von beiden Benutzern bearbeitet wurden, sind farblich markiert. Nach der Bearbeitung eines Absatzes verliert der Text jedoch diese Markierung.
Okay, verstanden.

Auswahl einer Textgrundlage
Zur Zusammenführung beider Versionen musst du mit den Knöpfen zwischen den Absätzen zunächst eine Version wählen, die als Bearbeitungsgrundlage dient. Die gewählte Version kann durch einen Klick auf den Stift bearbeitet werden. Aus der nicht gewählten Version kannst du Text mithilfe der Tastatur oder des rechten Mausklicks kopieren und in die bearbeitbare Version einfügen.
Um den zusammengeführten Text speichern zu können, musst du von jedem kollidierenden Absatz einen ausgewählt haben.
Okay, verstanden.

Change 408322 had a related patch set uploaded (by Andrew-WMDE; owner: Andrew-WMDE):
[mediawiki/extensions/TwoColConflict@master] [WIP] Have a tour to introduce the new Interface

https://gerrit.wikimedia.org/r/408322

WMDE-Fisch changed the point value for this task from 8 to 5.Feb 6 2018, 4:35 PM

Hi, there are two text changes to be done. They are collected in the document mentioned in T186613.

Addshore moved this task from Proposed to Doing on the WMDE-QWERTY-Sprint-2018-02-06 board.
Addshore added a subscriber: Andrew-WMDE.

@Hanna_Petruschat_WMDE & co, where is the image that is used in the mock located?

The patch is now ready except for adding the image seen in the mock.

The task also says

NB: For the prototype, we do not need the "do not show this info again" button. Always show the tour

So the checkbox has not been implemented.

The test site is now running with the latest patches and can be tested with the tour.

Might require a bit more attention to narrow screens :)

Screen Shot 2018-02-09 at 13.43.00.png (1×1 px, 295 KB)

Screen Shot 2018-02-09 at 13.43.06.png (1×1 px, 520 KB)

Same here with screen size 1280 x 800

EN

Bildschirmfoto 2018-02-09 um 14.02.22.png (1×2 px, 438 KB)
Bildschirmfoto 2018-02-09 um 14.05.40.png (1×1 px, 460 KB)

DE

Bildschirmfoto 2018-02-09 um 14.02.15.png (1×2 px, 528 KB)

Besides, the pulsating blue dots are not shown.

@Andrew-WMDE
Here is the image for the overlay

  • in small size

Graphic-Tutorial.png (169×599 px, 7 KB)

  • in bigger size (for resolution and screen size purposes)

Graphic-Tutorial-3x.png (507×1 px, 20 KB)

Also: the pop ups should show up one after the other with a "1/3" in brackets after headline. so people know how much more to expect. "Conflicting Versions (1/3)", "Choose a base version (2/3)", "Highlighted Text (3/3)"

Also: the pop ups should show up one after the other with a "1/3" in brackets after headline. so people know how much more to expect. "Conflicting Versions (1/3)", "Choose a base version (2/3)", "Highlighted Text (3/3)"

So we do want them to appear one after another / step by step?

I assume the below in your previous comment meant we no longer wanted them to appear in steps.

\\Please note, that there is no more step-by-step guidance on top of the site as it was shown in earlier drafts. Please remove them, should they be still in there.//

Sorry for the confusion. If I remeber right, this note was meant for the tutorial overlay, not for the tour we introduce here. To clarify:

  • The popups should show up, one after the other (This also helps prevent overlapping). This is also meant for now (the MVP). I think later on, we might introduce the glowing blue points
  • the first popup opens automatically after the introductional overlay was exited.
  • If one popup gets closed, the next one should open up automatically
  • To prevent the user from being scared of hundred more popups to come, we show the "n/3" next to the headline.

I hope that clarifies things.

Change 408322 abandoned by WMDE-Fisch:
[WIP] Have a tour to introduce the new Interface

Reason:
Squashed in
I267de58c2a3f965b8eebfb545e6b417601527191

https://gerrit.wikimedia.org/r/408322

Change 408322 restored by WMDE-Fisch:
[WIP] Have a tour to introduce the new Interface

Reason:
Ups

https://gerrit.wikimedia.org/r/408322

Change 408322 abandoned by WMDE-Fisch:
[WIP] Have a tour to introduce the new Interface

Reason:
Squashed in
I267de58c2a3f965b8eebfb545e6b417601527191

https://gerrit.wikimedia.org/r/408322