Page MenuHomePhabricator

[EPIC] Suggestion Mode: Introduce way to toggle Suggestion Mode ON/OFF
Open, Needs TriagePublic

Description

This is a tracking task for the work of enabling people, across experience levels and platforms, the ability to turn Suggestion Mode ON/OFF from within the visual editor.

Per what the Editing Team discussed on 11 March 2026, the work of implementing the full scope of this functionality will happen within ≥4 iterations (described below).

Stories

  1. People who are most often arriving into the editing interface clear about what they're wanting to change and/or add know what (if any) suggestions are available within the article they're editing without them being distracting from what they arrived intent on doing
  2. People who are most often arriving into the editing interface curious and not yet clear about what they are wanting to change/add can easily discover suggestions within the article they're editing while retaining the ability to turn them off in cases where they are arriving intent on making specific change/addition

Feature releases

ReleaseAudience(s)DescriptionPlatform(s)TicketNotes
v0.1Experienced volunteers who enabled the beta featureDesktop-only toggleDesktopT420245
v0.2Experienced volunteers who enabled the beta feature, Newcomers in controlled experimentDesktop-only toggle (w/ persistence)DesktopT420268
v1.0Experienced volunteers and newcomers editing on mobileSame as v.02 and now on mobileMobileT420419Work on this would happen after the controlled experiment (T404600) and before the default-on deployment (T414853)
v2.0Same as v1.0Update toggle to include real-time count of no. suggestions availableMobile + DesktopT420386

Note: find requirements in Editing Scratch (Product).


Related

Related Objects

Event Timeline

Per what @bmartinezcalvo and I discussed offline today, we need to decide whether the presence of this toggle is a requirement for the initial experiment (T404600).

bmartinezcalvo renamed this task from Suggestion Mode: Find a way to toggle suggestion mode on/off on (mobile + desktop) to Suggestion Mode: Find a way to toggle suggestion mode on/off on mobile + desktop.Feb 4 2026, 12:36 PM
bmartinezcalvo claimed this task.
bmartinezcalvo updated the task description. (Show Details)
ppelberg renamed this task from Suggestion Mode: Find a way to toggle suggestion mode on/off on mobile + desktop to Suggestion Mode: Find a way to toggle suggestion mode on/off (mobile).Feb 18 2026, 1:06 AM
bmartinezcalvo renamed this task from Suggestion Mode: Find a way to toggle suggestion mode on/off (mobile) to Suggestion Mode: Turning suggestion mode ON/OFF and improving discoverability of additional suggestions (ToggleButton: desktop + mobile).Feb 26 2026, 7:01 PM
bmartinezcalvo updated the task description. (Show Details)

Now that we're using this task as a tracking task, I'm moving some details from the task description into this comment so that the description is a bit easier to parse.

I'll gradually be moving the details from the below into the soon-to-be created network of sub-tasks.


Background

As part of the Suggestion Mode work, we need to decide the placement of the toggle to hide/show suggestions on both desktop and mobile.

NOTE: we will need to decide whether the presence of this toggle is a requirement for the initial experiment T404600.

Possible solutions

Op.1: ToggleButton within the edit toolbar

We could include the ToggleButton to turn suggestions on/off in the edit toolbar on both desktop and mobile. On mobile, we would need to group Cite and Link under a new “add” button on mobile to be able to:

  1. Make space for the Suggestions ToggleButton to be in a first level
  2. Make space for other options that are available on desktop but not on mobile (e.g. add image, add table) T385851
image.png (2,880×1,560 px, 1 MB)
image.png (736×496 px, 58 KB)
DesktopMobile

The Suggestions ToggleButton will show a badge with the number of available suggestions in the current page.

  • On desktop, it indicates the number of suggestions in all the article since all sections are loaded.
  • On mobile
    • When loading a section indicates the number of suggestions in that section
    • When loading full-page, indicates the number of suggestions in all the article
  • The badge has 2 states:
    • ToggleButton OFF: solid style to work as engagement for users to click on it
    • ToggleButton ON: outline state to look like a tracker rather than as a clickable element
  • When no suggestions remain
    • When suggestions ToggleButton is ON, the badge shows “0”.
    • When suggestions ToggleButton is OFF, the badge doesn’t appear.
Op.2: Option within the Edit menu in the toolbar (just on mobile)

In case we don't want to include a ToggleButton in a first level, we could also include it within the Edit menu. This option would not need to make any change in the toolbar organization, but the Suggestions toggle would be less findable.

image.png (2,880×1,560 px, 1 MB)
Captura de pantalla 2026-02-26 a las 15.44.35.png (1,258×1,374 px, 293 KB)
DesktopMobile

Acceptance criteria (or Done)

  • Explore solutions for the ToggleButton on both desktop on mobile
  • Test decided solution (if needed)
  • Implement decided approach
ppelberg renamed this task from Suggestion Mode: Turning suggestion mode ON/OFF and improving discoverability of additional suggestions (ToggleButton: desktop + mobile) to [EPIC] Suggestion Mode: Introduce way to toggle Suggestion Mode ON/OFF.Mar 16 2026, 7:26 PM
ppelberg removed bmartinezcalvo as the assignee of this task.