Page MenuHomePhabricator

Variant D (desktop): embed onboarding dialog into suggested edits module
Open, Needs TriagePublic

Description

T250343: Variant tests: D-desktop describes the onboarding dialog being embedded into the suggested edits module when it is not yet initiated. This includes the intro overlay as it exists currently (in variant A), and a modified version of the difficulty overlay as described in T258017: Variant D: difficulty overlay in onboarding.

Once onboarding is complete, the suggested edits module becomes initiated, and is replaced with its regular contents. There's no way to get back to the onboarding flow.

The module should be a fixed height (the height of the suggested edits module) with an internal scroll.

Mockups: step 1, step 2

Event Timeline

Catrope created this task.Jul 15 2020, 6:21 AM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJul 15 2020, 6:21 AM
MMiller_WMF added subscribers: kostajh, RHo, Tgr.
MMiller_WMF added a subscriber: MMiller_WMF.

Change 629528 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] Embed StartEditingDialog into the homepage in variant D on desktop

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

Code review from @kostajh led to a question for @RHo: should the embedded onboarding dialog keep the same height when moving between steps, like it does when it's a "real dialog"? The mockups suggest that it should, because the height is identical in the step 1 and step 2 mockups. But these are also misleading / not to scale: the step 1 mockup depicts 3 topic categories, but there are really 4, so step 1 is much taller than depicted. In practice, the height difference between step 1 (1067px) and step 2 (736px) is 331px, whereas the mockups show a consistent height of 748px and an implied height difference (if step 2 was shrunk to fit) of only 32px. Adding 300+ px of blank space to the bottom of step 2 seems like a lot, so I thought I should check first before I did that.

RHo added a comment.Sep 25 2020, 8:32 PM

Code review from @kostajh led to a question for @RHo: should the embedded onboarding dialog keep the same height when moving between steps, like it does when it's a "real dialog"? The mockups suggest that it should, because the height is identical in the step 1 and step 2 mockups. But these are also misleading / not to scale: the step 1 mockup depicts 3 topic categories, but there are really 4, so step 1 is much taller than depicted. In practice, the height difference between step 1 (1067px) and step 2 (736px) is 331px, whereas the mockups show a consistent height of 748px and an implied height difference (if step 2 was shrunk to fit) of only 32px. Adding 300+ px of blank space to the bottom of step 2 seems like a lot, so I thought I should check first before I did that.

Hi @Catrope - sorry my bad, I didn't clearly state that the suggested edits module should have it's height fixed to the size it will be when the suggestions are shown. So that's why there'd potentially be an inner scroll in the module (as depicted in this mock in the Zeplin):

Change 629528 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] Embed StartEditingDialog into the homepage in variant D on desktop

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

MMiller_WMF updated the task description. (Show Details)Mon, Sep 28, 5:37 PM
MMiller_WMF moved this task from QA to Needs More Work on the Growth-Team (Current Sprint) board.

@Catrope will work on the internal scroll issue.

Change 630912 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Use fixed height when embedded on the homepage

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

The patch above sets the height of the onboarding panel to (approximately, within a few pixels) the height that the suggested edits module will be when it activates, and makes the contents scrollable. It also tightens up the padding on the footer, per the Zeplin mock (it was inheriting the much more spacious padding from the dialog).

Change 631166 had a related patch set uploaded (by Kosta Harlan; owner: Kosta Harlan):
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Disallow escaping when user is in variant D

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

Change 630912 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Use fixed height when embedded on the homepage

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

RHo added a comment.Thu, Oct 1, 7:44 PM

hi @Catrope / @kostajh - as I was reviewing T258017, I noticed this screen has more than expected padding around the intro illustration and paragraph dialog:

Actual:
and
vs Expected:

Same goes with the topics area, which for the desktop should be 16px left and right padding, and 24px for top and bottom.

MMiller_WMF added a comment.EditedThu, Oct 1, 11:53 PM

@Catrope -- I noticed a requirement that was missed here, about two messages that need to be changed/added. This applies to mobile, too. They are the personalized messages based on welcome survey response. Basically, these new messages excise the part that tells the user to cancel out of the dialog before searching and clicking edit, because you can't cancel out of Variant D onboarding. I imagine it will be annoying to have to messages that are virtually the same between Variant C and D except for a couple words. How about this: we make the messages below the ones that go on Variant A, C, and D for this personalization. I think it's okay to skip the "cancel" part even when there is a dialog with a cancel button. Users can figure that out.

  • The copy will be largely the same as what was shown in the overlay, with some slight changes since the element is no longer an overlay. The following are the only two changed messages:
    • For users who said they wanted to correct a typo or error: When you created your account, you said you wanted to fix a typo or error. Here, you can find suggestions of small edits to get started. If you would rather go straight to fixing a specific article, you can search for the article and click "Edit".
    • For users who said they want to add or change information in an existing article: When you created your account, you said you wanted to add or change information on an existing article. Here, you can find suggestions of small edits to get started. If you would rather go straight to changing a specific article, you can search for the article and click "Edit".

Change 631166 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditing: Disallow escaping when user is in variant D

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

Change 631881 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Remove reference to "Cancel" button in intro messages

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

@Catrope -- I noticed a requirement that was missed here, about two messages that need to be changed/added. This applies to mobile, too. They are the personalized messages based on welcome survey response. Basically, these new messages excise the part that tells the user to cancel out of the dialog before searching and clicking edit, because you can't cancel out of Variant D onboarding.

Well spotted, sorry for missing this.

I imagine it will be annoying to have to messages that are virtually the same between Variant C and D except for a couple words.

I see that I have trained you well :-P

How about this: we make the messages below the ones that go on Variant A, C, and D for this personalization. I think it's okay to skip the "cancel" part even when there is a dialog with a cancel button. Users can figure that out.

  • The copy will be largely the same as what was shown in the overlay, with some slight changes since the element is no longer an overlay. The following are the only two changed messages:
    • For users who said they wanted to correct a typo or error: When you created your account, you said you wanted to fix a typo or error. Here, you can find suggestions of small edits to get started. If you would rather go straight to fixing a specific article, you can search for the article and click "Edit".
    • For users who said they want to add or change information in an existing article: When you created your account, you said you wanted to add or change information on an existing article. Here, you can find suggestions of small edits to get started. If you would rather go straight to changing a specific article, you can search for the article and click "Edit".

Done in the attached patch.

Change 631881 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Remove reference to "Cancel" button in intro messages

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

Etonkovidova added a subscriber: Etonkovidova.

(1) I did not see any changes made to address this comment - https://phabricator.wikimedia.org/T258019#6510238. Moving to Needs More Work .
e.g. 37px instead of 24px

The overall look:

(2) Checking the customized messages based on https://phabricator.wikimedia.org/T258019#6510951 - seem to be correct:

Variant D

Desktop betalabsmobile betalabs

Change 632830 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Padding fixes

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

(1) I did not see any changes made to address this comment - https://phabricator.wikimedia.org/T258019#6510238. Moving to Needs More Work .

Fixed in the attached patch.

Change 632830 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Padding fixes

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

(1) I did not see any changes made to address this comment - https://phabricator.wikimedia.org/T258019#6510238. Moving to Needs More Work .

Fixed in the attached patch.

Done Seems to me that it was the only one open issue here - moving to Design review.

Hi, moving back as a couple of padding issues remain on Desktop:

ActualExpectedDetails
Left and right padding in the desktop module intro topic area should only be 16px (not 24px)
Bottom padding in the desktop module intro topic area should only be 24px (not 35px)
Left and right in the desktop module topic selector area should only be 16px (not 24px)
Top and padding in the desktop module topic selector area should be 24px (not 21px)

I've also noticed new issues on the Mobile version now:

ActualExpectedDetails
There should not be a white gap between the stepper and intro text
Left and right padding in the mobile module should only be 16px (not 24px)
Bottom padding in the mobile module intro topic area should only be 16px (not 40px)
Left and right in the desktop module topic selector area should only be 16px (not 24px)
Top and padding in the mobile module topic selector area should be 16px (not 24px)

I'm confused about the left/right padding; I'm working on a patch currently to address the comment in T258016#6527139

There, @Catrope wrote:

There already is 16px padding (or margin) on the left+right hand sides in both panels, although it's 24px on the intro panel and 1em (=16px) on the difficulty panel for some reason. This appears to have been done deliberately, and only on mobile (on desktop both panels have 24px left+right side padding). If you want me to remove this odd exception and make it 24px everywhere, I would be more than happy to do that.

and @RHo replied:

Yes, but can we make it so that on Mobile there is 1em (16px) padding on left and right everywhere?

So, my patch is implementing 24px left/right padding on Vector (desktop) and 16px left/right padding on Minvera (mobile). But based on the previous comment on this task (T258019#6536126) it sounds like that was incorrect reading on my part?

Clarified with @RHo in chat, the intention is for 16px side padding on desktop and mobile. (And that is implemented in this patch.)

Change 634596 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Styling tweaks for variant C/D

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

Desktop issues:

Left and right padding in the desktop module intro topic area should only be 16px (not 24px)

Kosta's patch fixed this

Bottom padding in the desktop module intro topic area should only be 24px (not 35px)

My patch on T258016 fixed this.

Left and right in the desktop module topic selector area should only be 16px (not 24px)

This is also part of Kosta's fix.

Top and [bottom] padding in the desktop module topic selector area should be 24px (not 21px)

Fixed in my new patch.

Mobile issues:

There should not be a white gap between the stepper and intro text

This should already be fixed, Kosta pointed it out to me soon after I broke it, and I fixed it that same day.

Left and right padding in the mobile module should only be 16px (not 24px)

This is also fixed by Kosta's patch.

Bottom padding in the mobile module intro topic area should only be 16px (not 40px)

I'll take this as an answer to my questions at T258017#6549150: yes you do want these vertical paddings to be 24px on desktop and 16px on mobile. I will do that in a separate patch that tackles both the ones identified here and in T258017.

Left and right in the desktop [sic] module topic selector area should only be 16px (not 24px)

Kosta's patch fixed this.

Top and padding in the mobile module topic selector area should be 16px (not 24px)

This will also be part of the separate 24->16 change.

I think this belongs in Code Review. Please move it to the right place if I'm wrong!

Change 634596 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Styling tweaks for variant C/D

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

Change 635904 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Use smaller padding for mobile in various places

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

Change 635904 had a related patch set uploaded (by Catrope; owner: Catrope):
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Use smaller padding for mobile in various places

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

This changes the top and bottom padding on the topic selector div from 24px to 16px on mobile, as discussed in T258019#6557184.

Change 635904 merged by jenkins-bot:
[mediawiki/extensions/GrowthExperiments@master] StartEditingDialog: Use smaller padding for mobile in various places

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