Page MenuHomePhabricator

Newcomer tasks: suggested edits initiation and overlays
Closed, ResolvedPublic

Description

This task is about adding the actual suggested edits module to the homepage, and the first things that happen after the user interacts with. Other tasks exist for the module itself, the way the homepage changes when it is initiated. This task may be too large, and we should make sub-tasks if necessary.

Note on platforms: all these specifications will need to apply to both desktop and mobile. During the time that explicit mockups for mobile are not available, engineers should use their judgment to build mobile versions. Those initial builds can be modified later as the mobile designs are finalized.

Initiating suggested edits
Current mockup

  • Replace the “userpage” submodule of the start module with a new “suggested edits” submodule.
    • The title of the module should be “Start editing”, and it should have an editing pencil icon.
    • The text of the module is personalized according to the user’s response to the welcome survey’s first question about why they created their account. Here are the rules:
      • “To fix a typo or error in a Wikipedia article” -> “Find articles that need small fixes!”
      • “To add a photo or image to a Wikipedia article” -> “Before adding an image, try learning with some easier edits!”
      • “To create a new Wikipedia article” -> “Before creating a new article, try learning with some easier edits!”
      • Any other response, or no response -> “Wikipedia is written by people like you. Even small edits make a difference.”
    • The button reads “See suggested edits”.
  • When the user clicks “See suggested edits”, the first overlay of the suggested edits module appears.
  • Note that the suggested edits module is not "initiated" until the user completes the difficulty overlay that comes up once the call-to-action is clicked in the start module. Once they complete the overlay, the homepage changes permanently for that user. See T232420 for this next step.

NOTE: the overlay specifications below have been superseded by the specifications in T235723. That's because we split the difficulty overlay into two separate overlays.

Difficulty overlay
Current mockup

  • If the topic overlay exists, the difficulty overlay comes after the topic overlay. If the topic overlay does not exist, the difficulty overlay is the only overlay.
  • After initiating suggested edits by clicking the call-to-action in the start module, the difficulty overlay appears on top of the newcomer homepage.
  • This overlay contains static written information and imagery about different kinds of suggested edits.
    • Users who gave certain responses to the “task” question from the welcome survey will have content in the overlay according to their response (to be written). Users who gave other responses or do not have a response will have a default set of content in the overlay.
    • Certain parts of the overlay will be the same for all users.
  • The user has two options:
    • “Go back”: if the topic overlay does not exist, this button closes the overlay and returns the user to their homepage exactly the way it was before they clicked the call-to-action in the start module. If the topic overlay exists, it returns to the user to the topic overlay, where the user can change their topic selections.
    • “Continue”: this closes the overlay and allows the user to see their suggested edits module.

Below is a list of non-engineering items that need to be complete before this task is complete, but that do not block engineering:

  • Add mobile designs.
  • Finalize which task types are listed as "Easy", "Medium", "Hard" in the copy.
  • Finalize copy for call-to-action and overlay.

Event Timeline

MMiller_WMF renamed this task from Newcomer tasks: suggested edits initiation from homepage to Newcomer tasks: suggested edits initiation and overlays.Sep 10 2019, 12:25 AM
MMiller_WMF updated the task description. (Show Details)

Change 536719 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] [WIP] Homepage: startediting placeholder module for suggested edits

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

Change 538690 had a related patch set uploaded (by Kosta Harlan; owner: Kosta Harlan):
[operations/mediawiki-config@master] GrowthExperiments: Enable suggested edits feature flag on beta

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

Change 538691 had a related patch set uploaded (by Kosta Harlan; owner: Kosta Harlan):
[operations/mediawiki-config@master] GrowthExperiments: Ensure suggested edits feature is off in prod

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

Change 538690 merged by jenkins-bot:
[operations/mediawiki-config@master] GrowthExperiments: Enable suggested edits feature flag on beta

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

Change 538691 merged by jenkins-bot:
[operations/mediawiki-config@master] GrowthExperiments: Ensure suggested edits feature is off in prod

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

Mentioned in SAL (#wikimedia-operations) [2019-09-23T21:32:21Z] <catrope@deploy1001> Synchronized wmf-config/VariantSettings.php: Syncing no-op change for T232419 (duration: 00m 57s)

Change 538352 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] Add JS and dialog for startediting module

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

Change 536719 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] Homepage: Add startediting placeholder module for suggested edits

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

Change 538352 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] Add JS and dialog for startediting module

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

@Catrope - according to the specs the text for the selected Welcome survey option - "To add or change information to a Wikipedia article" should be “Wikipedia is written by people like you. Even small edits make a difference.” ( not "Learn to edit articles with some easy edits first!").

Since there are some updates to overall treatment/workflow of the difficulty overlay and topic overaly, @RHo, @MMiller_WMF - can you review my questions?

(1)

This overlay contains static written information and imagery about different kinds of suggested edits.

Users who gave certain responses to the “task” question from the welcome survey will have content in the overlay according to their response (to be written). Users who gave other responses or do not have a response will have a default set of content in the overlay.
Certain parts of the overlay will be the same for all users.

  • The Welcome survey does not have 'task' questions anymore.
  • If the requirements are still "to be written" - should that spec be in this task?

If those specs are removed (and @Catrope submitted a patch for correcting the mismatch mentioned in my above comment), then this task would be just for PM/Design Review.

(2) The mockup for the difficulty overlay has two buttons with "Get suggestions" and "Back". The specs mentions "Continue" and "Go back". The current implementation has buttons - "Get suggestions" and "Cancel". Please confirm that the implemented labels are ok.

Screen Shot 2019-10-08 at 12.07.56 PM.png (535×723 px, 201 KB)

Change 541631 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Remove special message for add-change response

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

Change 541631 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Remove special message for add-change response

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

Welcome survey option - Why did you create your account today?Start editing module text
no selection; To add or change information to a Wikipedia article; I'm participating in a program, class, or event; To read Wikipedia; Other
Screen Shot 2019-10-08 at 11.08.43 AM.png (311×242 px, 22 KB)
To fix a typo or error in a Wikipedia article
Screen Shot 2019-10-08 at 11.26.26 AM.png (256×233 px, 18 KB)
To add a photo or image to a Wikipedia article
Screen Shot 2019-10-08 at 11.10.34 AM.png (298×238 px, 20 KB)
To create a new Wikipedia article; To add or change information to a Wikipedia article
Screen Shot 2019-10-08 at 11.11.21 AM.png (260×240 px, 20 KB)

In the Difficulty overlay current mockup, I read "making <lang> Wikipedia better". Can't we have "making <Wiki name> better" to simplify deployments on non-Wikipedias?

In the Difficulty overlay current mockup, I read "making <lang> Wikipedia better". Can't we have "making <Wiki name> better" to simplify deployments on non-Wikipedias?

Hi @Trizek-WMF, that's a good thought. I think we are still noodling with the final copy on this, so have added as a comment on the copy doc linked on ticket T233762

Hi, please note there's a couple of differences with expected from final copy in the copy doc (I've added an "expected" column):

Welcome survey option - Why did you create your account today?Start editing module text (Actual)Expected text
no selection; To add or change information to a Wikipedia article; I'm participating in a program, class, or event; To read Wikipedia; Other
Screen Shot 2019-10-08 at 11.08.43 AM.png (311×242 px, 22 KB)
Help add to the world's knowledge with some easy fixes on Wikipedia articles.
To add or change information to a Wikipedia article (even though the copy is the same as above right now, we may want different text in future)
Screen Shot 2019-10-08 at 11.08.43 AM.png (311×242 px, 22 KB)
Help add to the world's knowledge with some easy fixes on Wikipedia articles.
To fix a typo or error in a Wikipedia article
Screen Shot 2019-10-08 at 11.26.26 AM.png (256×233 px, 18 KB)
Start making small fixes now with these easy suggestions!
To add a photo or image to a Wikipedia article
Screen Shot 2019-10-08 at 11.10.34 AM.png (298×238 px, 20 KB)
As expected
To create a new Wikipedia article; To add or change information to a Wikipedia article
Screen Shot 2019-10-08 at 11.11.21 AM.png (260×240 px, 20 KB)
As expected

This task should now only be used for working on and testing the submodule inside the start module. All overlay content has been re-specified in this subtask because we split the difficulty overlay into two separate overlays: T235723: Newcomer tasks: intro and difficulty overlays

@Etonkovidova -- can you please specify why this task is In Progress? Is there something that needs to be worked on?

I just tested and confirmed today that the correct personalization is happening with each welcome survey response. The text in the start module changes appropriately.

@MMiller_WMF

I just tested and confirmed today that the correct personalization is happening with each welcome survey response. The text in the start module changes appropriately.

The personalization of 'Start editing' message is still as per this comment - https://phabricator.wikimedia.org/T232419#5572581. On trnslatewiki.net -
Growth Experiments - Homepage does not have messages such as "Help add to the world's knowledge with some easy fixes on Wikipedia articles." and "Start making small fixes now with these easy suggestions!"

The following applies to the intro difficulty personalization?

This task should now only be used for working on and testing the submodule inside the start module. All overlay content has been re-specified in this subtask because we split the difficulty overlay into two separate overlays: T235723: Newcomer tasks: intro and difficulty overlays

There appears to be a dispute over copy, so we need you to weigh in @MMiller_WMF

@Etonkovidova is right. The module is not using the correct copy in some cases, as shown in @RHo's table in T232419#5572581. This is going back to Ready for Development to make those changes.

@Etonkovidova -- do you see similar issues with the intro overlay's personalized messages? Or are those all okay? T235723: Newcomer tasks: intro and difficulty overlays

Change 556303 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Update subheader copy

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

I've merged this, but noted in the patch that we should probably be using {{SITENAME}} rather than the word "Wikipedia" so that GrowthExperiments could be used on other projects (Commons, WikiVoyage, etc).

Change 556303 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Update subheader copy

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

Once this patch is merged, remember to remind the ambassadors to get the changed messages retranslated (they are growthexperiments-homepage-startediting-subheader-edit-typo and growthexperiments-homepage-startediting-subheader-other).

Translations have been updated only for Arabic.

Thanks. @Etonkovidova -- do you see similar issues with the intro overlay's personalized messages? Or are those all okay?

Thanks. @Etonkovidova -- do you see similar issues with the intro overlay's personalized messages? Or are those all okay?

The only issue is that the translations are not yet done for Czech and Vietnamese. For the translations that are in place - Arabic and Korean - the personalized messages work correctly and based on Welcome Survey answers.