Page MenuHomePhabricator

Prototype Tone Check "Revise" workflow
Open, Needs TriagePublic

Description

This task involves the work of prototyping the Revise workflow the Editing Team sketched out during the team's 26 March offline discussion.

Story

As someone who has been made aware that the text I'm attempting to add to Wikipedia is likely to contain biased language and who has just expressed interest in revising the tone of what I've written, I want the next step for doing this to be clear and to feel supported in taking it, so that I do not become stuck/confused about what I'm meant to be doing.

Requirements

  1. Tap Revise button with an Peacock Check card/hint, regardless of the moment it is presented within (e.g. Mid-Edit, Pre-Save)
  2. Notice the text that's currently highlighted in yellow'ish changes to a different highlight color and an accompanying border is addd (akin to what's done with links) and your cursor is dropped into the beginning end of the text you've written that prompted the Peacock Check to activate
    • Notes:
      • For the purpose of a demo, we're going to try gray.
      • The text will remain editable
  3. Notice that when you tap/click anywhere within the document outside of the text you've written that prompted the Peacock Check to activate, the highlight returns to it's "normal" activated state and the border is removed

Open questions

  • Will we move forward with the approach described by the Requirements above?
  • If we decide to move forward with this approach, what – if any – adjustments will we make?
  • Should the gray remain after the cursor leaves the paragraph, until the server-side recheck is complete? (If so, the gray really indicates "recheck pending", which may influence other UX decisions)

Done

Event Timeline

ppelberg moved this task from Inbox to Ready to Be Worked On on the Editing-team (Kanban Board) board.
ppelberg updated the task description. (Show Details)
dchan updated the task description. (Show Details)

Updates / Next steps

Aklapper renamed this task from Prototype Peacock Check "Revise" workflow to Prototype Tone Check "Revise" workflow.May 28 2025, 11:43 AM

Updates / Next steps

Cursor placement has been updated and the change committed via T394818.

QA of this work can happen after Wednesday 4 June 2025, once T394818 is merged.

Next step

  • @dchan to re-implement and team to decide whether we move forward with this implementation in the time between now and when we more holistically consider this experience in T397984

Next step

  • @dchan to re-implement and team to decide whether we move forward with this implementation in the time between now and when we more holistically consider this experience in T397984

To clarify, these changes amount to the following:

  1. When you tap Revise from within the Tone Check card, turn text highlight gray
  2. When you adjust any facet of the text text within the span that initially caused Tone Check to be shown, turn text highlight to gray
  3. Re-run Tone Check when you move the cursor's focus or press Publish

I'm not sure we should be turning the highlight grey -- that overlaps with the "the surface doesn't have focus" color, which might be confusing.

Change #1168649 had a related patch set uploaded (by Divec; author: Divec):

[mediawiki/extensions/VisualEditor@master] Add paused state, for when current fragment text does not match what was checked

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

Test wiki created on Patch demo by ESanders (WMF) using patch(es) linked to this task:
https://patchdemo.wmcloud.org/wikis/7e2751a4d2/w/