Page MenuHomePhabricator

Adjust when to show the quick tutorial
Closed, ResolvedPublic

Description

Section Translation shows a quick tutorial (T250898) when users start a new translation.
Currently this is shown for every single translation, which adds some friction as shown in recent research.

This ticket proposes to reduce this frequency. Some options to consider:

  • Show it only once.
  • Show it again after a long period of time without translating (as a reminder).
  • (add more options)

Update:

Following initial investigation the approach to be adapted is defined as below:

The quick tutorial should be displayed only for users that haven't translated any section before. When the user has already created a section translation, even draft, the quick tutorial will be skipped and the user will be navigated directly to the "Pick a sentence step".


It should be possible to force the appearance of the tutorial (through url parameter, or Javascript console) for testing purposes. Also considering to make these views available on Storybook would be helpful for testing, reference, and avoiding regressions. This is captured in a follow-up task: T345366: SX: Add control to forcefully display the quick tutorial when desired

Event Timeline

Change 934249 had a related patch set uploaded (by Nik Gkountas; author: Nik Gkountas):

[mediawiki/extensions/ContentTranslation@master] SX: Skip quick tutorial when user already has section translations

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

@Pginer-WMF above I have submitted a patch that displays the quick tutorial based on the following logic:

The quick tutorial should be displayed only for users that haven't translated any section before. When the user has already created a section translation, even draft, the quick tutorial will be skipped and the user will be navigated directly to the "Pick a sentence step".

Do you think we could follow this approach?

@Pginer-WMF above I have submitted a patch that displays the quick tutorial based on the following logic:

The quick tutorial should be displayed only for users that haven't translated any section before. When the user has already created a section translation, even draft, the quick tutorial will be skipped and the user will be navigated directly to the "Pick a sentence step".

Do you think we could follow this approach?

Yes. That makes sense.

The only consideration is that we may need some way to reset this in case we want to test the tutorial.
This could be a url parameter to force the tutorial to appear (or a more explicit option in the help panel if we want editors to have a way to check it gain, especially if we evolve it in the future to cover more details). We don't need to support this from the beginning (a follow-up can be created) but having this inmind may help to support this ticket in a way that is compatible with the follow-up one.

ngkountas changed the task status from Open to In Progress.Jul 5 2023, 7:57 AM

Change 934249 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] SX: Skip quick tutorial when user already has section translations

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

Change 936678 had a related patch set uploaded (by Nik Gkountas; author: Nik Gkountas):

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20230710

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

Change 936678 abandoned by Nik Gkountas:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20230710

Reason:

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

Change 946931 had a related patch set uploaded (by Nik Gkountas; author: Nik Gkountas):

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20230808

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

Change 946931 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20230808

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

The quick tutorial is now skipped for users that have at least one section translation (draft or published). However, there is no way to forcefully display the quick tutorial, yet, but this issue is now tracked in T345366. This issue can be closed.

Screencast from greek (el) production wiki, for users with section translations:

Screencast from greek (el) production wiki, for users without section translations: