Page MenuHomePhabricator

Create final copy and illustration for VE Suggestion Mode beta feature
Closed, ResolvedPublic

Description

Background

This task involves the work of creating an illustration that will appear within Special:Preferences#mw-prefsection-betafeatures.

Illustration references

Here is what Editing implemented for DiscussionTools:

image.png (410×642 px, 10 KB)

More example illustrations here: https://www.mediawiki.org/wiki/Beta_Features#Current_features_gallery

Story

  • As an experienced volunteer, I'd value seeing an illustration within beta features that enables me to, at a glance, decide whether this is a feature I'd like to consider enabling.
  • As a member of the team developing the Suggestion Mode beta feature, I'd like for volunteers browsing Beta Features within Special:Preferences to see an illustration that compels them to explore the feature further and ultimately, decide whether they'd like to enable it or not.

Requirements

IllustrationTBD
TitleSuggestion Mode
DescriptionCommunity-configurable edit suggestions for improving Wikipedia articles. Available in [[:mw:VisualEditor|visual editor]].
Link ("Information")[[:mw:VisualEditor/Suggestion_Mode]]
Link ("Discussion")[[:mw:Talk:VisualEditor/Suggestion_Mode]]

Illustrations

Explorations

image.png (1×3 px, 106 KB)

Final illustration

Copy proposed

Include here the copy for the Suggestion Mode Beta feature.

Acceptance criteria (or Done)

  • Illustrations
    • 3 illustration options are created and documented in the "Ideas" section above
    • The 3 illustration options are shared in the #edit-suggestions Slack channel for feedback
    • An illustration is chosen and implemented to appear alongside the Suggestion Mode feature once it is enabled as a beta feature via (T399611)
  •  Copy
    • Decide on the best copy for the Suggestion Mode Beta feature
    • Make a redirect from [[:mw:Edit check/Suggestions]] to [[:mw:VisualEditor/Suggestion_Mode]]
    • Make a redirect from [[:mw:Talk:Edit check/Suggestions]] to [[:mw:Talk:VisualEditor/Suggestion_Mode]]
  • Create a new patch to implement the copy changes T404603#11581280 specifies and deploy on the train that will go out the week of 9 Feb

Event Timeline

3 illustration options are created and documented in the "Ideas" section above

I don't think we need to over think this. These thumbnails and functional, and would mostly be used by users who have seen the feature elsewhere. As long as it looks roughly like a screenshot of the feature it will be fine.

Sharing here for visibility. These are the 3 illustrations I've been working on. I was waiting to see if something in the Suggestion mode change in case I need to update the illustrations, but I can always update the final illustration once the Suggestion mode work is completed.

image.png (1×3 px, 106 KB)

Ths first one looks good to me. Can you attach SVGs?

Ths first one looks good to me. Can you attach SVGs?

Here is the SVG for the first illustration.

DLynch renamed this task from Create illustration for VE Suggestion Mode to Create final copy and illustration for VE Suggestion Mode beta feature.Jan 26 2026, 6:16 PM

Community-defined edit suggestions for improving Wikipedia articles. Available in [[:mw:VisualEditor|visual editor]].

I think we should say "configured" rather than "defined". Also we should drop "Wikipedia" for reasons mentioned before around difficulties in translating {{SITENAME}}.

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

Change #1229113 merged by jenkins-bot:

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

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

Proposing some copies for the Beta feature:

Option 1:

Show suggestions to improve existing article content. Suggestions are optional improvements configured by the community and available in the visual editor.

Option 2:

Show suggestions in the visual editor to improve existing article content.

  • Suggestions are configured by the community.
  • They are optional — you can review or skip them.
  • You can turn them off at any time.
DLynch added subscribers: EAkinloose, DLynch.

@EAkinloose pointed out that the information / discussion links don't go to existing pages, and that the suggestion_mode page on metawiki is probably the intended ones.

It'd be easiest if we made a redirect on metawiki from plain suggestions to the page we want, and updated the copy with a patch and then let that change roll out on next week's train.

ppelberg updated the task description. (Show Details)

@EAkinloose pointed out that the information / discussion links don't go to existing pages, and that the suggestion_mode page on metawiki is probably the intended ones.

I've updated the task description (T404603#11581280) to reflect the pages we'd like the beta feature copy to link to.

It'd be easiest if we made a redirect on metawiki from plain suggestions to the page we want, and updated the copy with a patch and then let that change roll out on next week's train.

Sounds good. I've updated the task description's "Done" to include the above.

Change #1248563 had a related patch set uploaded (by Medelius; author: Medelius):

[mediawiki/extensions/VisualEditor@master] Suggestion mode: update name to be consistent

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

Change #1248563 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Suggestion mode: update name to be consistent

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