Page MenuHomePhabricator

Display unstructured Suggested Edits onboarding on first use only
Open, MediumPublic3 Estimated Story Points

Description

User story & summary:

As an editor who completes Suggested Edits tasks (eg. "Copyedit", "Find references"), I want to see the onboarding only on my first attempt at each task type, so that I can start editing immediately on future tasks without repeating the quick start tips.

Screenshot 2025-08-21 at 4.08.33 PM.png (1×726 px, 111 KB)

Design:

N/A

Acceptance Criteria:

AC1: First-time onboarding display
Given a user initiates a unstructured suggested edit for the first time (eg. "Find references")
When the task is initiated
Then the onboarding dialog automatically opens to step 1

AC2: Onboarding suppression for completed task types
Given a user has previously completed onboarding for a specific task type (eg. "Find references")
When they initiate the same task type again
Then the onboarding dialog does not automatically open

AC3: Cross-device and cross-browser sync
Given a user has completed onboarding for a task type on one device/browser
When they initiate the same task type on a different device or browser
Then the onboarding dialog does not automatically open (preference is tied to the user account, not the device)

AC4: Independent task type preferences
Given a user has completed onboarding for one task type (eg. "Find references")
When they initiate a different task type (eg. "Copyedit") for the first time
Then the onboarding dialog opens normally for the new task type

All tasks should also meet the Growth Team’s task completion definition.

Event Timeline

AAlhazwani-WMF renamed this task from Allow editors to opt-out of seeing Suggested Edits onboarding repeatedly to Display unstructured Suggested Edits onboarding on first use only.Jan 21 2026, 3:48 PM
AAlhazwani-WMF updated the task description. (Show Details)

Testing notes:
On enwiki beta - a user will see expanded Help panelevery time when landing on un-structured suggestion article. The Help panel doesn't preserve the closed state when a user closes it.

Structured tasks present a module intro tour; the Help panel is displayed closed.

Urbanecm_WMF set the point value for this task to 3.Mon, Feb 23, 5:15 PM

This might require us to pay off technical debt (related to user options usage). Related tasks: T54777, T383700