Page MenuHomePhabricator

Revise Tone: Decline suggestion UX
Closed, ResolvedPublic5 Estimated Story Points

Description

User story & summary:

As a newcomer, I want the option to decline (or skip) a suggestion and immediately receive another one, so that the Suggested Edits experience feels consistent and continuous.

Background & research:

This task is important because all Suggested Edits should follow a predictable flow: selecting a task > completing or skipping it > moving on to another suggestion.

Design:

Figma Revise Tone specs

  • After completing (or skipping) the onboarding newcomers are redirected to VisualEditor. We will bring them to highlighted paragraph, with the Edit check bottom sheet (or card on desktop) active.
  • On “Revise”, newcomers can edit the page.
  • On “Decline”, newcomers need to answer a short survey to fully decline the suggestion.

Screenshot 2025-09-21 at 3.08.01 PM.png (1×1 px, 324 KB)

  • When newcomers decline the “Review tone” suggestion they will be re-directed to the review view of the article.
  • We will display the same message that we display for when newcomers complete other types of suggested edits, see T301603.
  • As the message fades out, we will display another suggestion.

'

Screenshot 2025-09-21 at 3.08.17 PM.png (1×1 px, 443 KB)

Acceptance Criteria:

Given I clicked into an Edit Check from a Suggested Edit on the Homepage,
When I decline a task and then complete the survey,
Then I am directed to the article's read view and I receive a Thank you confirmation (Thanks for reviewing suggestions. Keep going!)
And as that confirmation message fades away, we display the post-edit dialog with another Suggested Edit

Event Timeline

KStoller-WMF triaged this task as High priority.
KStoller-WMF moved this task from Inbox to Up Next (estimated tasks) on the Growth-Team board.
KStoller-WMF set the point value for this task to 5.Sep 22 2025, 4:08 PM

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

[mediawiki/extensions/GrowthExperiments@master] feat(ReviseTone): Show post-edit dialog if check was declined

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

@KStoller-WMF @AAlhazwani-WMF Question about an edge-case:

Given that I clicked into an Edit Check from a Suggested Edit on the Homepage,
And that I revised the indicated paragraph somewhat
And that I try to save my changes
And that when my revised text is checked again and the model still finds a tone issue present
And that thus I'm shown again with a Tone Edit Check in the before-save stage
When I decline that Edit Check and then complete the survey,
Then ... ?

Should we still close the editor (but prompt the user whether they really want to close), or should the Edit Check just close as usual so that they can save their edit? I'd recommend the latter, but wanted to check in around that.

Michael moved this task from Incoming to Code Review on the Growth-Team (Current Sprint) board.

The question above aside, the associated change should be ready for review and merging.

Thanks for thinking through these possible edge cases!
Given that they wanted to save changes and publish, presumably we should still allow the newcomer to save, so yes, the Edit Check should close as usual so that they can save their edit.

Side note: hopefully we track how often newcomers end up in loops like this. Ideally we avoid scenarios where this happens often, as I imagine it would feel frustrating and confusing for a new editor.

Change #1191712 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] feat(ReviseTone): Show post-edit dialog if check was declined

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

Test Result

Status: ✅ PASS
Test Details: T401195#11279755

This task’s QA is included under T401195’s Revise Tone QA, which will cover the decline / skip behavior and flow.