Page MenuHomePhabricator

Recommended reading exp: Final design review and adjustments for recommended articles
Closed, ResolvedPublic3 Estimated Story Points

Description

Background

This task is for final design tweaks for the recommended articles experience for new registered readers.

Requirements

  • @Sneha is able to review and list out final design changes
  • Changes are made to the styling of experiment UI elements
  • Final design sign-off on the recommended articles

Testing steps

Recommended to test on test.wikipedia.org or test2.wikipedia.org. Former needs a new account registered after 9 September 2026 to opt into experiment.

Steps:

  1. Login to the wiki
  2. Ensure that "Display newcomer homepage" under "Newcomer editor features" is activated in your settings
  3. Visit Special:Homepage with ?mpo=de-1-3-1-specialhomepage-onboarding-ab-test:treatment in the URL (as URL param hence the ?) to display the daily reads module. Should be hidden in non-treatment.

To stop appending the param on every request, set the override cookie once in the browser DevTools console:

mw.loader.using( 'ext.testKitchen' ).then( () => mw.testKitchen.overrideExperimentGroup( 'de-1-3-1-specialhomepage-onboarding-ab-test', 'treatment' ) );

To reset the setup motivation and see the dialog again:

new mw.Api().saveOption( 'growthexperiments-account-setup-motivation', null );

Acceptance criteria for done

nice to have

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes

@AAlhazwani-WMF & @Sneha I need your help: The GrowthExperiments went with a _much_ stronger backdrop treatment for all(?) of their dialogs.
In my conviction that's hurting usability as the user looses context of where they came from – one of the reasons behind a not fully opaque backdrop:

image.png (2,804×1,054 px, 212 KB)

The reason is a non-DS backdrop filter backdrop-filter: blur(30px), which itself is an interesting addition, but definitely not at 30px. It has not been raised against Codex before. 2px would be sufficient enough.

image.png (2,652×1,008 px, 305 KB)

@AAlhazwani-WMF & @Sneha I need your help: The GrowthExperiments went with a _much_ stronger backdrop treatment for all(?) of their dialogs.
In my conviction that's hurting usability as the user looses context of where they came from – one of the reasons behind a not fully opaque backdrop:

image.png (2,804×1,054 px, 212 KB)

The reason is a non-DS backdrop filter backdrop-filter: blur(30px), which itself is an interesting addition, but definitely not at 30px. It has not been raised against Codex before. 2px would be sufficient enough.

image.png (2,652×1,008 px, 305 KB)

disclaimer: i still need to test the recent changes, so we may tweak this.

the rationale behind the strong backdrop filter is that the account setup dialog opens automatically after account creation. this is not a dialog that opens from the newcomer homepage. we wanted to create a more focused and separated experience, lowering the risk of a brand new account being "distracted" by what's behind the dialog (especially on desktop).

this treatment should apply only to the account setup dialog, not to all dialogs. i will test this to make sure this is implemented as desired.

Change #1341427 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@master] styles: Clamp lines at two for long Wikidata descriptions.

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

Assigning early to you @Sneha for Phab workboard clarity.

Change #1341427 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat(AccountSetup), styles: Clamp long Wikidata descriptions.

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

Let me know when its ready to review

Change #1343168 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@master] feat(AccountSetup), styles: Apply correct background and button styles

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

All the issues captured in this comment except the position of module (which will be handled by ed growth team) will be done as part of this task. cc @Volker_E for documentation

Change #1343572 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@master] [WIP] feat(AccountSetup): Prefer Wikidata descriptions over local ones

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

Just reviewing the patch and there's an alignment or spacing issue with the .growthexperiments-reading-recommendations-personalize-button that would be good to fix with this task. See pic for reference.

image.png (1,084×646 px, 80 KB)

Additional items for @Sneha review - the two items below were transferred here from https://phabricator.wikimedia.org/T435521#12336195

(3) There are some discrepancies between design and implementation - please review to decide whether some adjustments are needed. Specifically,

  • the background of the card - the background in the design has a light blue color
  • the button - the design uses Primary progressive; enwiki beta shows Normal progressive
Designenwiki beta
image.png (1,712×3,804 px, 713 KB)
Screenshot 2026-09-17 at 6.41.21 PM.png (852×1,598 px, 254 KB)
image.png (1,728×1,639 px, 274 KB)
Screenshot 2026-09-17 at 6.44.07 PM.png (2,276×1,686 px, 338 KB)

Change #1343168 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat(AccountSetup), styles: Apply correct background and button styles

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

I was able to test this on test wiki. Can we fix the two things @Etonkovidova highlighted that are still the case on both desktop and mobile

  • the background of the card to select interest should be gray50 #f8f9fa
  • the button on that card should be primary progressive

Nice to have if we have time is to increase the size of the thumbnails.
cc @Volker_E

I was able to test this on test wiki. Can we fix the two things @Etonkovidova highlighted that are still the case on both desktop and mobile

  • the background of the card to select interest should be gray50 #f8f9fa

This has already been fixed, see the patch in the task description. In case you tested on test.wikipedia.org, it might not have made the cut y'day in time. Tomorrow should be visible.

  • the button on that card should be primary progressive

Relying on that Growth does really take their primary progressive off the table. It's still on on test.wikipedia.org. The SuggestedEdits module is still visible.

Nice to have if we have time is to increase the size of the thumbnails.

This was already in place in my Vue list patch, but didn't make it in the other path taken from Anne's patch on yet.

		.cdx-card__thumbnail,
		.cdx-card__thumbnail .cdx-thumbnail__image,
		.cdx-card__thumbnail .cdx-thumbnail__placeholder {
			min-width: @size-400;
			width: @size-400;
			height: @size-400;
		}

Thanks I will check tomorrow.

Relying on that Growth does really take their primary progressive off the table. It's still on on test.wikipedia.org. The SuggestedEdits module is still visible.

Is this a technical limitation? From the design point of view Amin and I agreed that its okay to leave both as progressive primary for both modules since this is only for the experiment and things will change later.

Change #1344742 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@master] feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations

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

Thanks I will check tomorrow.

Relying on that Growth does really take their primary progressive off the table. It's still on on test.wikipedia.org. The SuggestedEdits module is still visible.

Is this a technical limitation? From the design point of view Amin and I agreed that its okay to leave both as progressive primary for both modules since this is only for the experiment and things will change later.

That's a design system premise for guiding users. If two competing elevated button actions are in one view, they should turn into normal progressive buttons, not both primary progressive. (my phrasing)

@Volker_E if the user has selected "reading and exploring" then we should have the button in reading module to be primary progressive. I am not sure if the growth team has time to switch their's to normal progressive. If they do great. Otherwise I think we can make reading module one primary when the user has selected reader role

Also I checking again today for background task below, looks like its not made it to test wiki yet.

the background of the card to select interest should be gray50 #f8f9fa

Also one more thing that I did not mention here but we chatted about it was having the button and text align in the center of the card as shown below for Desktop

image.png (1,340×240 px, 25 KB)
(This is nice to have)

If keeping both mobile and desktop card style the same is simpler for now then we can align both to the left. Let me know what is more feasible right now in the given time in terms of alignment and button size.

Change #1344742 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations

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

Change #1344771 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.21] feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations

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

Change #1344772 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.21] feat(AccountSetup), styles: Apply correct background and button styles

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

@Sneha jfyi, when I put an acceptance criteria with a patch done and it's merged, it won't be on test.wikipedia.org until late deploy Mon-Thu.

Volker_E set the point value for this task to 3.Fri, Sep 25, 4:03 PM
Volker_E updated Other Assignee, added: LMora-WMF.

Putting to 3 story points for now based on active feedback after 48h, we can still discuss to change later.

Change #1344771 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.21] feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations

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

Change #1344772 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.21] feat(AccountSetup), styles: Apply correct background and button styles

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

Mentioned in SAL (#wikimedia-operations) [2026-09-28T14:20:47Z] <lucaswerkmeister-wmde@deploy1003> Started scap sync-world: Backport for [[gerrit:1344771|feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations (T436332)]], [[gerrit:1344772|feat(AccountSetup), styles: Apply correct background and button styles (T436332)]]

Mentioned in SAL (#wikimedia-operations) [2026-09-28T14:24:54Z] <lucaswerkmeister-wmde@deploy1003> lucaswerkmeister-wmde, volker-e: Backport for [[gerrit:1344771|feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations (T436332)]], [[gerrit:1344772|feat(AccountSetup), styles: Apply correct background and button styles (T436332)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-09-28T14:54:31Z] <lucaswerkmeister-wmde@deploy1003> Finished scap sync-world: Backport for [[gerrit:1344771|feat(AccountSetup), styles: Increase thumbnail size in ReadingRecommendations (T436332)]], [[gerrit:1344772|feat(AccountSetup), styles: Apply correct background and button styles (T436332)]] (duration: 33m 44s)

Change #1345572 had a related patch set uploaded (by Michael Große; author: Michael Große):

[mediawiki/extensions/GrowthExperiments@master] fix(ReadingRecommendations): keep the icon-only interests button small

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

Change #1345572 abandoned by VolkerE:

[mediawiki/extensions/GrowthExperiments@master] fix(ReadingRecommendations): keep the icon-only interests button small

Reason:

Got weaved into I4165181e5d5e0ccfed. Thanks Michael!

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

Change #1345992 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@master] fix(ReadingRecommendations): Update button style to primary

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

Change #1345992 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] fix(ReadingRecommendations): Update button style to primary

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

Change #1347606 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.22] fix(ReadingRecommendations): Update button style to primary

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

Just waiting for nice-to-have primary button backport in late backport window in about 4h from now.

Jdlrobson-WMF subscribed.

I don't see any code review needs so I'm moving this to sign off for now. @Volker_E please move back to QA/code review if further work/QA is needed! Thanks in advance!

Change #1347606 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@wmf/1.47.0-wmf.22] fix(ReadingRecommendations): Update button style to primary

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

Mentioned in SAL (#wikimedia-operations) [2026-10-01T20:14:28Z] <cjming@deploy1003> Started scap sync-world: Backport for [[gerrit:1347606|fix(ReadingRecommendations): Update button style to primary (T436332)]], [[gerrit:rEDOI13477127b80e|instrument(WelcomeSurvey): align motivation event with AccountSetup (T439887)]], [[gerrit:1347743|instrument(AccountSetup): Record setup motivation on page_visit (T439217)]]

Mentioned in SAL (#wikimedia-operations) [2026-10-01T20:18:22Z] <cjming@deploy1003> cjming, volker-e: Backport for [[gerrit:1347606|fix(ReadingRecommendations): Update button style to primary (T436332)]], [[gerrit:rEDOI13477127b80e|instrument(WelcomeSurvey): align motivation event with AccountSetup (T439887)]], [[gerrit:1347743|instrument(AccountSetup): Record setup motivation on page_visit (T439217)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can

Mentioned in SAL (#wikimedia-operations) [2026-10-01T20:32:57Z] <cjming@deploy1003> Finished scap sync-world: Backport for [[gerrit:1347606|fix(ReadingRecommendations): Update button style to primary (T436332)]], [[gerrit:rEDOI13477127b80e|instrument(WelcomeSurvey): align motivation event with AccountSetup (T439887)]], [[gerrit:1347743|instrument(AccountSetup): Record setup motivation on page_visit (T439217)]] (duration: 18m 28s)

Backport succeeded. I think @Sneha would be a good person to sign this off.