Page MenuHomePhabricator

Adapt user experience to expose the progressive rollout with a fallback link
Closed, DeclinedPublicFeature

Description

Once we default SUL3 to enabled (for a specific user or more generally), we want to provide them with a SUL2 fallback in case of problems:

  • ensure that during login and signup there is a link saying something like "We are testing a new login flow. If you are encountering problems, click here to try the old one." with the link adding a usesul3=0 query parameter
  • verify that the query parameter actually works (in theory T377924 / T375788 / T376488 cover this but it wasn't heavily tested)
  • The user is not opting out of SUL3, they are using a fallback and will re-enter SUL3 loop next time they try to log in.

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

Do we actually want to do this? I'm not sure that we do.

If there are problems after rolling out, we should be rolling back, fixing and trying again. Not letting people opt out.

Do we actually want to do this? I'm not sure that we do.

If there are problems after rolling out, we should be rolling back, fixing and trying again. Not letting people opt out.

If someone is confused about things rather than the procedure being broken, this lets them go back to a method they know and can rely on. This can be useful. I agree that if things are out-and-out bugged, we want to know about it.

On the other hand, this isn't an optional change.

If someone is confused about it or doesn't want to use the new method,
we're not giving them that choice.

I really think this is an "it works or it doesn't" situation.

larissagaulia renamed this task from Create notice and opt-out mechanism for SUL3 to Adapt user experience to expose the progressive rollout with a fallback link. .Jan 27 2025, 3:29 PM
larissagaulia updated the task description. (Show Details)
Aklapper renamed this task from Adapt user experience to expose the progressive rollout with a fallback link. to Adapt user experience to expose the progressive rollout with a fallback link.Jan 27 2025, 3:49 PM

Change #1118840 had a related patch set uploaded (by Gergő Tisza; author: Gergő Tisza):

[mediawiki/extensions/CentralAuth@master] SUL3: Add notice about new login system, with a fallback link

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

Screenshots:

{F58390817}
Screenshot Capture - 2025-02-11 - 16-45-40.png (1×1 px, 291 KB)
Screenshot Capture - 2025-02-12 - 13-25-25.png (2×1 px, 268 KB)
Screenshot Capture - 2025-02-12 - 13-25-55.png (2×1 px, 340 KB)
desktop logindesktop signupmobile login (Chrome devtools simulated Pixel 7)mobile signup (Chrome devtools simulated Pixel 7)

Proposed notice text:

We are updating the login system. See here for more information. If something doesn't work, you can use the old one.

Proposed help page text:

We are updating our authentication system to use a single domain name. Before, every Wikimedia wiki had its own login and signup form - if you were logging into the English Wikipedia, you used en.wikipedia.org, for Wikidata you would use www.wikidata.org. To be more compatible with modern browsers, the new system always uses auth.wikimedia.org for showing login and signup forms. The behavior of these forms should be otherwise unchanged.

To find out more about the authentication update project, see mw:MediaWiki Platform Team/SUL3. For technical details, see (TBD). If you want to report a bug, use Phabricator and add the #SUL3 tag. If you are not sure how to do that, you can also use the talk page of this page.

Frequently asked questions:

  • How do I know if I can trust this new domain?
  • wikimedia.org is operated by the same organization (the Wikimedia Foundation) as Wikipedia, Wikidata etc. You can find a small "Wikimedia project" logo in the footer of the page you started from.
  • Why am I / am I not seeing the new login page?
  • We are rolling out the changes gradually; see here for the schedule. We are trying our best to make the experience consistent; once you have signed up or logged in using the dedicated domain, we try to always show that domain to you. Because the system needs to make that decision before you enter your username, there are practical limits to how reliably that can work.
  • The new login or signup page is not working for me!
  • Please describe the issue in detail so we can fix it. In the meanwhile, you can use the old system by clicking the link in the notice on the top of the login / signup form (it will say something like "use the old one").

@JTweed-WMF @Quiddity let me know what you think!

For Tech News: Thanks for the draft! I'd tweak that to: (1) remove the "we" (always ambiguous), and (2) fix the "here" (mystery-meatball link label), plus (3) adding a rough time-scale, and (4) a clear "why/benefits" for the whole project, for folks who don't click-through to the details.
So something roughly like this? (Any tweaks/rewrites, and final-link selections, are still needed please!)

The login system at all Wikimedia wikis is being updated over the next two months. These changes should making logging in more consistent across all wikis, and are also necessary to work with recent web-browser anti-tracking features. You can read more details at the project Help page. During the changeover, if something doesn't work as expected, you can still use the old login system.

@Tgr It looks like 3 of the screenshots might be restricted, as they are not viewable by me; the spots where those should appear are blank, just showing { F-number-here }

Did a couple of mobile screen emulation with Google Chrome dev tools, below are a few screenshots

Screenshot 2025-02-13 at 1.33.37 PM.png (1×1 px, 267 KB)
Screenshot 2025-02-13 at 1.32.53 PM.png (1×1 px, 282 KB)
Screenshot 2025-02-13 at 1.32.12 PM.png (1×1 px, 284 KB)
Screenshot 2025-02-13 at 1.32.39 PM.png (1×1 px, 259 KB)
Screenshot 2025-02-13 at 1.33.16 PM.png (1×1 px, 237 KB)
Screenshot 2025-02-13 at 1.31.56 PM.png (1×1 px, 266 KB)
Screenshot 2025-02-13 at 1.32.24 PM.png (1×1 px, 264 KB)
Screenshot 2025-02-13 at 1.33.58 PM.png (1×2 px, 212 KB)
Screenshot 2025-02-13 at 1.31.38 PM.png (1×1 px, 264 KB)
Screenshot 2025-02-13 at 1.31.26 PM.png (1×1 px, 246 KB)

Ignore the "Wikipedia" logo, that's just my local setup. The focus is the "We are updating the login system. See here for more information. If something doesn't work, you can use the old one." notice.

I've run the suggestion of a notice with fallback link past @mwilliams from Design.

We agreed that a fallback link is not necessary here and that even a notice may be undesirable, as it has the potential to cause confusion especially as it won't be localised as part of rolling out. We feel that, especially given the technical mitigations we are working on (shared credentials, asset links), that finding a saved password or a password reset is a one time minor inconvenience for a small subset of users, which doesn't justify adding a notice.

We do think that adding something to the help is a good idea. I'm happy to pick that up and rework the draft above.

One question for @Quiddity - not all wikis link to the same help page and right now it looks like English Wikipedia links to a generic MediaWiki help page while other wikis have custom pages. What would be normal for us to do here? Just update the generic MediaWiki help page and leave it to communities to update any local pages in their own time if so desired?

I'm less concerned about passwords (users for whom credential sharing between domains doesn't work will have to manually find and copy their password at some point, I don't think letting them delay that makes all that much difference) and more about authentication simply not working for some subset of users for some unforseen reason + about users not understanding why they are seeing an unfamiliar domain (I guess more of an issue for login than for signup).

The focus is the "We are updating the login system. See here for more information. If something doesn't work, you can use the old one." notice.

Note: We should avoid using "here" or "click here" as a link label. (That's known as Mystery meat navigation, and is bad for screenreaders, and for intuitively understanding a link's destination, and for sighted users to see the link at all because "here" is so short in English.) -- I won't attempt to suggest a rewrite immediately, per the uncertainties below.

One question for @Quiddity - not all wikis link to the same help page and right now it looks like English Wikipedia links to a generic MediaWiki help page while other wikis have custom pages. What would be normal for us to do here? Just update the generic MediaWiki help page and leave it to communities to update any local pages in their own time if so desired?

Re: If I understand correctly, and after looking around, I think you mean that:

I believe it would be normal for us to simply update the existing official documentation and let the communities update their custom local versions. Potentially we could highlight in Tech News that the main documentation has been overhauled, and that any custom local variants should be updated accordingly.

Question for you (all): Are we planning on updating the existing page (mw:Help:Logging_in), and/or are we planning on creating a new page (i.e. Tgr's earlier draft message links to the currently non-existent m:Help:Single_login_domain)?

larissagaulia subscribed.

The final decision from product and design is that we will not have the fallback.

Change #1118840 abandoned by Gergő Tisza:

[mediawiki/extensions/CentralAuth@master] SUL3: Add notice about new login system, with a fallback link

Reason:

per task

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