In the account creation form cleanup (T415659), we moved the "(username policy)" link into the username field description as a "Learn more" link within the text "Your username is public and cannot be made private later. Learn more." This follow-up task replaces the current behavior - navigating users away to the full username policy page - with an in-page popover that surfaces a TLDR of the policy, keeping users in the account creation flow.
User story & summary:
As a new user creating an account on mobile web, I want to preview a summary of the username policy without leaving the account creation form so that I can quickly understand the guidelines and choose an appropriate username.
Background & research:
Currently, tapping the "Learn more" link in the username field description navigates users away from the account creation page to the full username policy. This disrupts the registration flow and adds friction - especially on mobile, where navigating back requires extra steps. Surfacing a concise summary in a popover keeps users in context while still providing a path to the full policy if needed.
Design:
Scope: this task is scoped to Mobile only.
Acceptance Criteria:
The popover should use the Codex Popover component (Codex Popover). The mobile version of the component is currently in review: https://gerrit.wikimedia.org/r/c/design/codex/+/1234447
AC1
- Given I am on the account creation page on mobile web
- When I tap the "Choose carefully" link in the username field description
- Then a popover appears displaying a TLDR of the username policy
AC2
- Given the username policy popover is open
- When I read the popover content
- Then I see a summary of the username policy as a bulleted list
AC3
- Given the username policy popover is open
- When I tap the link to the full username policy, eg. "offensive"
- Then I am navigated to the full username policy page, eg. https://en.wikipedia.org/wiki/Wikipedia:Username_policy#Disruptive_or_offensive_usernames
AC4
- Given the username policy popover is open
- When I tap outside the popover or tap the close button
- Then the popover is dismissed and I remain on the account creation page
Open questions:
Which part of the username field description should serve as the link trigger for the popover? Options include the full "Learn more" text, just "public," or another approach.- "Choose carefully"
- Confirm the three bullet items for the username policy TLDR in the popover (current candidates based on existing policy page: "Don't use offensive, misleading, or promotional names," "Username must represent you as an individual, not an organization," "Consider privacy risks before using your real name").
Should the full username policy open in the same tab or in a new tab?- New tab

