Page MenuHomePhabricator
Create Task
Maniphest T399611

[MILESTONE] Deploy Suggestion Mode MVP as a beta feature (en.wiki)
Open, Needs TriagePublic
Actions

Description

This task holds the body of work that will need to be completed before we can deploy VE's new Suggestion Mode (desktop + mobile) as a Beta Feature.

Deployment details

Wikis: All Wikipedias
Announcement published: Monday, 2 February 2026
All patches merged: Monday, 2 February 2026
Deployment timing: Thursday, 5 February 2026

Requirements

What follows is a draft. @ppelberg to finalize this once T414626 gains the list of the suggestions that are currently available.

User experience

  • Every logged in user at all Wikipedias who navigates to Special:Preferences#mw-prefsection-betafeatures will see a new beta feature available called Suggestion Mode
  • When someone enables the feature – manually or by way of having the Automatically enable most beta features enabled – they will make the following true:
    • Anytime they open the visual editor (desktop or mobile) they will gain the potential to see the Edit Suggestions that are relevant to the content within the article they are viewing
      • Note: "Edit Suggestions" in this context refers to the set of suggestions we will define in T402242.

Meta

  • All Suggestions we deem "fit" to appear in Suggestion Mode will, for now, be available to everyone who has Suggestion Mode enabled, regardless of their experience level.
    • Where "fit" here refers to all Suggestions that are not marked experimental.
    • Note: we anticipate ourselves needing to be able to specify the experience level someone must have to see a given Edit Suggestion. Although, we will prioritize that via T410524 in advanced of the A/B experiment we will be running in T404600.

Decisions to be made

  • 5. What (if any) copy changes are needed to Checks we will offer in Suggestion Mode? T415849

Decided

  • 1. Will the Beta feature include experimental Suggestions? Which current experimental checks should be deployed as part of the beta feature? See T402242 and T404599.
  • 9. Do we want to deploy current in-review suggestions: 1) Heading structure, 2) Redirect links, and 3) Year target/label link mismatch?
  • 2. Technically, what is the beta feature? E.g. will it effectively be doing ecenable=1, and thus turning on checks for users who don’t meet e.g. the editcount requirements?
    • DECIDED: This will be effectively be turning on ecenable=1 WITHOUT affecting what Checks are presented to people.
  • 3. Will the Beta Feature be offered to all wikis or to specific wikis (i.e. is there a config turning the beta feature on/off?)
    • We will offer the beta feature at all Wikipedias.
  • 4. Prior to the Beta Feature release, will we make it possible for a Check to only show in Suggestion Mode?
    • Yes and that will be implemented via T409476
  • 6. Where should the ToggleButton to show/hide suggestions be placed on mobile? T415589
    • DECIDED: deploying the beta feature will NOT be blocked on introducing a button within the UI to turn Suggestion Mode ON/OFF. Instead, people will only be able to turn Suggestion Mode ON/OFF by way of enabling/disabling the beta feature.
    • On desktop, this ToggleButton will be placed in the edit toolbar, but since there is no space in the mobile toolbar, we need to choose an alternative placement (e.g. a sticky bottom Button) for now unless we decide to redesign the elements in the toolbar T400903.
  • 7. At what point do we send off a Suggestion's UI copy to be translated?
    • DECIDED: we will send Suggestions UI copy to be translated before the deployment of Suggestion Mode as a beta feature at all wikis (T415320); copy will be finalized in T414987
    • Proposed: the patch which moves a check out of "experimental" should also add the translation changes, and enabled should be set to true later once we're happy to go ahead
    • Note: per T399611#11547165, we will not block the en.wiki Beta Feature deployment on UI strings being translated.
    • Related: T414987.
  • 8. Do want to implement the new blue styling for suggestion cards as seen in this demo: https://9e25b0c40d.catalyst.wmcloud.org/w/index.php?title=Douglas_Adams&veaction=edit&ecenable=suggestions%2Cexperimental

Details

Related Changes in Gerrit:
SubjectRepoBranchLines +/-
Edit check suggestions beta-feature in allowlistoperations/mediawiki-configmaster+2 -1
Edit check: enable suggestions beta-feature on enwikioperations/mediawiki-configmaster+5 -0
Customize query in gerrit

Related Objects
Search...

StatusSubtypeAssignedTask
 OpenNoneT360489 [EPIC] Generate and present edit suggestions at scale
 OpenNoneT414853 [MILESTONE] Deploy Suggestion Mode as a default-on feature.
 OpenNoneT404600 [MILESTONE] Run controlled experiment of Suggestion Mode MVP
 OpenNoneT415320 [MILESTONE] Deploy Suggestion Mode MVP as a beta feature (all Wikipedias)
 OpenNoneT399611 [MILESTONE] Deploy Suggestion Mode MVP as a beta feature (en.wiki)
 ResolvednayoubT401020 Define the Suggestion Mode user experience (MVP)
 OpenNoneT402242 Define suggestions to include in Suggestion Mode MVP
 ResolvedDLynchT404602 [SPIKE] Investigate feasibility of running Tone Check in Suggestion Mode
 ResolvedQuiddityT414626 Update mw:Edit check/Deployment Status to include currently available Checks/Suggestions
 ResolvedppelbergT404603 Create final copy and illustration for VE Suggestion Mode beta feature
 ResolvedppelbergT404470 [MILESTONE] Offer Suggestion Mode via URL parameter
 ResolvedDLynchT399612 Create VE Suggestion Mode MVP
 ResolvedDLynchT401342 Tone check forcing itself selected interferes with other checks
 DuplicateNoneT404599 [SPIKE] Decide what – if any – features will we remove from Suggestion Mode MVP
 ResolvedppelbergT397379 Identify initial set of suggestions to surface within Suggestion Mode
ResolvedBUG REPORTDLynchT413279 Convert Reference Suggestion - restrict to references that are just a link
 ResolvedBUG REPORTEsandersT413277 External link check should ignore links to Sister Projects
 OpenNoneT414898 Facilitate conversion of external links to references in External Link Check
 ResolvedbmartinezcalvoT406808 Conduct usability study of Suggestion Mode MVP (newcomers)
 OpenNoneT407168 Gather qualitative feedback about Suggestion Mode MVP (Sr. Contributors)
 ResolvedQuiddityT409604 Invite volunteers to a community conversation about edit suggestions/signals
 ResolvedDLynchT407170 Create Superset dashboard to see how edit suggestions are performing (overall and by type)
 ResolvedmedeliusT407286 Log sub-types of textmatch checks to VEFU
 ResolvedmedeliusT409206 Add instrumentation to detect when someone starts an edit session with suggestions enabled
 ResolvedDLynchT408890 Write script that will cause Suggestion Mode to be enabled by default
 ResolvedppelbergT409605 Record and share a demo of the TextMatch work in progress
 ResolvedmedeliusT410955 Implement editcheck config option to specify minimum edit count
 ResolvedppelbergT411149 Publish Suggestion Mode project page
 ResolvedEsandersT411380 Experimental DisambiguationEditCheck doesn't work in suggestion mode
 OpenmedeliusT413419 Append a tag to edits in which ≥1 Edit Suggestion was visible in the browser viewport
 OpenmedeliusT412334 Add instrumentation to measure suggestion visibility within VisualEditor
 In ProgresszoeT413420 [Suggestion] Detect when a variety of English is being used that does not align with article's tag
 ResolvedzoeT413763 Implement a "variety of english" edit check using the new TextMatchEditCheck implementation
 DeclinedzoeT414191 Add link filter to TextMatchEditCheck?
 OpenQuiddityT414627 Implement a volunteer-written wordlist to base the initial Engvar Edit Suggestion on
 ResolvedDLynchT414694 TextMatchEditCheck doesn't reflect ignoreLeadSection on individual match configurations
 ResolvedmedeliusT411662 Consider splitting up Edit Check config
 OpenzoeT413421 [Suggestion] Detect if an internal link appears >1x in the same section
 OpenzoeT415381 Bug: DuplicateLinkEditCheck - in a long section the widget appears in the wrong place
 ResolvedDLynchT416049 Duplicate Links: reduce the scope of the check to only find duplicates within a single paragraph
 ResolvedBUG REPORTEsandersT413276 External link check should not be shown within subsections of the excluded sections
 ResolvedQuiddityT414854 Announce availability of Suggestion Mode beta feature (en.wiki)
 ResolvedFeaturemedeliusT409476 Allow EditChecks to be check-only or suggestion-only
 ResolvedBUG REPORTmedeliusT407849 EditCheck doesn't detect a sfn template and shows message about absent source
 ResolvedDLynchT415226 Inserted templates and preexisting templates have very different structures
 ResolvedEsandersT415504 EditCheck: Create beta feature preference
 ResolvedDLynchT415936 Implement v1 of Suggestion feedback flow

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes
ppelberg removed a subtask: T404606: Introduce Suggestion Mode-specific dismiss survey.Fri, Jan 16, 11:47 PM
ppelberg created subtask T414854: Announce availability of Suggestion Mode beta feature (en.wiki).
ppelberg removed a subtask: T400189: Editcheck waits for all promises to resolve before displaying any checks.Fri, Jan 16, 11:52 PM
ppelberg removed a subtask: T360487: Explore moments when we might surface edit suggestions within VE.
ppelberg removed a subtask: T404604: Design Suggestion "card" component MVP.
ppelberg updated the task description. (Show Details)Fri, Jan 16, 11:55 PM
ppelberg removed a subtask: T410098: Ensure Revise Tone suggestion copy is consistent across contexts.
Esanders subscribed.Tue, Jan 20, 1:15 PM

In addition to an illustration (T399611) we also need a title, description and links for "Information"/"Discussion" (e.g. [[:mw:Edit check/Suggestions]] and [[:mw:Talk:Edit check/Suggestions]])

gerritbot added a comment.Tue, Jan 20, 1:16 PM

Change #1229113 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] EditCheck: Create beta preference for suggestions mode

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

gerritbot added a project: Patch-For-Review.Tue, Jan 20, 1:16 PM
ppelberg added a subtask: T414987: Review/update copy and internationalisation (i18n) of all check/suggestion types.Tue, Jan 20, 5:45 PM
Urbanecm_WMF added a project: GrowthExperiments-NewcomerTasks.Wed, Jan 21, 2:32 PM
ppelberg mentioned this in T409476: Allow EditChecks to be check-only or suggestion-only.Wed, Jan 21, 6:35 PM
ppelberg added a subtask: T409476: Allow EditChecks to be check-only or suggestion-only.
ppelberg removed a subtask: T410524: Enable Edit Checks and Suggestions to be independently configured.Wed, Jan 21, 6:39 PM
ppelberg closed subtask T410955: Implement editcheck config option to specify minimum edit count as Resolved.Wed, Jan 21, 8:21 PM
ppelberg updated the task description. (Show Details)Thu, Jan 22, 6:15 PM
ppelberg updated the task description. (Show Details)Thu, Jan 22, 6:21 PM
bmartinezcalvo updated the task description. (Show Details)Thu, Jan 22, 6:22 PM
bmartinezcalvo updated the task description. (Show Details)
bmartinezcalvo updated the task description. (Show Details)
ppelberg updated the task description. (Show Details)Thu, Jan 22, 6:26 PM
ldelench_wmf added a subtask: T415304: [Suggestion mode] Differentiate copy for suggestions and checks.Thu, Jan 22, 6:27 PM
zoe updated the task description. (Show Details)Thu, Jan 22, 6:30 PM
ppelberg updated the task description. (Show Details)Thu, Jan 22, 7:53 PM
ppelberg updated the task description. (Show Details)Thu, Jan 22, 8:33 PM
ppelberg added a subtask: T407849: EditCheck doesn't detect a sfn template and shows message about absent source.Thu, Jan 22, 10:19 PM
ppelberg renamed this task from [MILESTONE] Deploy Suggestion Mode MVP as a beta feature to [MILESTONE] Deploy Suggestion Mode MVP as a beta feature (en.wiki).Thu, Jan 22, 11:18 PM
ppelberg added a parent task: T415320: [MILESTONE] Deploy Suggestion Mode MVP as a beta feature (all Wikipedias).
ppelberg removed a parent task: T404600: [MILESTONE] Run controlled experiment of Suggestion Mode MVP.
ppelberg removed a subtask: T414987: Review/update copy and internationalisation (i18n) of all check/suggestion types.
ppelberg added a comment.Thu, Jan 22, 11:20 PM
In T414854#11547049, @ppelberg wrote:

Per offline discussion with @Quiddity, we're going to offer the Suggestion Mode beta feature in two phases:

  • Phase #1: en.wiki (T399611)
  • Phase #2: all other Wikipedias (T415320)

Rationale: we are splitting up the deployment into two phases so that we can afford volunteers the space to translate the Suggestion Mode UI string before the feature becomes available on-wiki.

ppelberg mentioned this in T414854: Announce availability of Suggestion Mode beta feature (en.wiki).Thu, Jan 22, 11:21 PM
ppelberg updated the task description. (Show Details)Thu, Jan 22, 11:23 PM
ppelberg updated the task description. (Show Details)
ppelberg created subtask T415323: Create a community configurable way to include links within Edit Check/Suggestion Cards.Thu, Jan 22, 11:39 PM
Esanders created subtask T415504: EditCheck: Create beta feature preference.Mon, Jan 26, 9:46 AM
Esanders updated the task description. (Show Details)Mon, Jan 26, 6:40 PM
bmartinezcalvo mentioned this in T415589: Suggestion Mode: Find a way to toggle suggestion mode on/off on mobile + desktop.Mon, Jan 26, 7:32 PM
ppelberg updated the task description. (Show Details)Mon, Jan 26, 7:55 PM
bmartinezcalvo updated the task description. (Show Details)Tue, Jan 27, 5:39 PM
ppelberg updated the task description. (Show Details)Tue, Jan 27, 6:04 PM
ppelberg updated the task description. (Show Details)Tue, Jan 27, 6:35 PM
ppelberg updated the task description. (Show Details)Tue, Jan 27, 6:37 PM
ppelberg updated the task description. (Show Details)
ppelberg added a comment.Wed, Jan 28, 1:19 AM
  1. Do want to implement the new blue styling for suggestion cards as seen in this demo: https://9e25b0c40d.catalyst.wmcloud.org/w/index.php?title=Douglas_Adams&veaction=edit&ecenable=suggestions%2Cexperimental

Yes and see comments in T404604#11560850.

ppelberg updated the task description. (Show Details)Wed, Jan 28, 1:20 AM
ppelberg added a subscriber: bmartinezcalvo.
DLynch subscribed.Wed, Jan 28, 4:05 PM
Ryasmeen closed subtask T413276: External link check should not be shown within subsections of the excluded sections as Resolved.Wed, Jan 28, 8:31 PM
ppelberg updated the task description. (Show Details)Thu, Jan 29, 12:42 AM
ppelberg updated the task description. (Show Details)Thu, Jan 29, 1:01 AM
Sdkb subscribed.Thu, Jan 29, 5:17 AM
ppelberg updated the task description. (Show Details)Thu, Jan 29, 6:13 PM
ppelberg mentioned this in T401739: Introduce a way to offer feedback about Edit Suggestions.Thu, Jan 29, 6:55 PM
ppelberg created subtask T415936: Implement v1 of Suggestion feedback flow.Thu, Jan 29, 6:59 PM
ppelberg removed a subtask: T401739: Introduce a way to offer feedback about Edit Suggestions.
ppelberg removed a subtask: T415323: Create a community configurable way to include links within Edit Check/Suggestion Cards.Thu, Jan 29, 7:02 PM
ppelberg updated the task description. (Show Details)Fri, Jan 30, 7:44 PM
ppelberg removed a subtask: T413257: [Meta] Define the deployment path for new Edit Checks/Suggestions.
ppelberg removed a subtask: T415304: [Suggestion mode] Differentiate copy for suggestions and checks.
ldelench_wmf closed subtask T409476: Allow EditChecks to be check-only or suggestion-only as Resolved.Mon, Feb 2, 7:36 PM
EAkinloose closed subtask T415504: EditCheck: Create beta feature preference as Resolved.Tue, Feb 3, 6:33 PM
EAkinloose closed subtask T411380: Experimental DisambiguationEditCheck doesn't work in suggestion mode as Resolved.Tue, Feb 3, 6:56 PM
DLynch closed subtask T415936: Implement v1 of Suggestion feedback flow as Resolved.Tue, Feb 3, 8:14 PM
ppelberg closed subtask T401020: Define the Suggestion Mode user experience (MVP) as Resolved.Tue, Feb 3, 8:17 PM
ppelberg mentioned this in T401020: Define the Suggestion Mode user experience (MVP).
ppelberg reopened subtask T415936: Implement v1 of Suggestion feedback flow as Open.Wed, Feb 4, 5:43 PM
ppelberg closed subtask T415936: Implement v1 of Suggestion feedback flow as Resolved.Tue, Feb 10, 1:02 PM
ppelberg closed subtask T404603: Create final copy and illustration for VE Suggestion Mode beta feature as Resolved.Tue, Feb 10, 1:05 PM
ppelberg removed a subtask: T404607: Design Suggestion Mode "Success" state/feedback.
ppelberg closed subtask T397379: Identify initial set of suggestions to surface within Suggestion Mode as Resolved.Tue, Feb 10, 1:08 PM
ppelberg closed subtask T414854: Announce availability of Suggestion Mode beta feature (en.wiki) as Resolved.
gerritbot added a comment.Tue, Feb 10, 4:17 PM

Change #1238383 had a related patch set uploaded (by DLynch; author: DLynch):

[operations/mediawiki-config@master] Edit check: enable suggestions beta-feature on enwiki

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

gerritbot added a comment.Tue, Feb 10, 9:03 PM

Change #1238383 merged by jenkins-bot:

[operations/mediawiki-config@master] Edit check: enable suggestions beta-feature on enwiki

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

Stashbot added a comment.Tue, Feb 10, 9:03 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:03:40Z] <kemayo@deploy2002> Started scap sync-world: Backport for [[gerrit:1238382|Edit check: turn off the addReference a/b test on enwiki (T367343 T416378)]], [[gerrit:1238383|Edit check: enable suggestions beta-feature on enwiki (T399611)]]

Stashbot mentioned this in T367343: [config] Make Edit Check (references) available to Phase 3 wikis.Tue, Feb 10, 9:03 PM
Stashbot mentioned this in T416378: [Config] Deploy config change to STOP the Reference Check A/B experiment (en.wiki).
Stashbot added a comment.Tue, Feb 10, 9:05 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:05:55Z] <kemayo@deploy2002> kemayo: Backport for [[gerrit:1238382|Edit check: turn off the addReference a/b test on enwiki (T367343 T416378)]], [[gerrit:1238383|Edit check: enable suggestions beta-feature on enwiki (T399611)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Stashbot added a comment.Tue, Feb 10, 9:13 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:13:38Z] <kemayo@deploy2002> Finished scap sync-world: Backport for [[gerrit:1238382|Edit check: turn off the addReference a/b test on enwiki (T367343 T416378)]], [[gerrit:1238383|Edit check: enable suggestions beta-feature on enwiki (T399611)]] (duration: 09m 58s)

gerritbot added a comment.Tue, Feb 10, 9:15 PM

Change #1238430 had a related patch set uploaded (by DLynch; author: DLynch):

[operations/mediawiki-config@master] Edit check suggestions beta-feature in allowlist

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

gerritbot added a comment.Tue, Feb 10, 9:18 PM

Change #1238430 merged by jenkins-bot:

[operations/mediawiki-config@master] Edit check suggestions beta-feature in allowlist

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

Stashbot added a comment.Tue, Feb 10, 9:19 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:19:13Z] <kemayo@deploy2002> Started scap sync-world: Backport for [[gerrit:1238430|Edit check suggestions beta-feature in allowlist (T399611)]], [[gerrit:1238049|Turn on Parsoid read views by default on labs (take 2) (T357054)]], [[gerrit:1238427|Update title / desc of Special:LintTemplateErrors (T170874)]]

Stashbot mentioned this in T170874: Provide additional Linter statistics about template-generated issues.Tue, Feb 10, 9:19 PM
Stashbot mentioned this in T357054: Use Parsoid HTML for all page views on beta cluster.
Stashbot added a comment.Tue, Feb 10, 9:44 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:44:08Z] <kemayo@deploy2002> cscott, arlolra, kemayo: Backport for [[gerrit:1238430|Edit check suggestions beta-feature in allowlist (T399611)]], [[gerrit:1238049|Turn on Parsoid read views by default on labs (take 2) (T357054)]], [[gerrit:1238427|Update title / desc of Special:LintTemplateErrors (T170874)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Stashbot added a comment.Tue, Feb 10, 9:59 PM

Mentioned in SAL (#wikimedia-operations) [2026-02-10T21:58:59Z] <kemayo@deploy2002> Finished scap sync-world: Backport for [[gerrit:1238430|Edit check suggestions beta-feature in allowlist (T399611)]], [[gerrit:1238049|Turn on Parsoid read views by default on labs (take 2) (T357054)]], [[gerrit:1238427|Update title / desc of Special:LintTemplateErrors (T170874)]] (duration: 39m 46s)

Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits