Page MenuHomePhabricator

Resolve tension between prominence of 'Help' and 'Suggestion Mode'
Open, Needs TriagePublic

Description

In Visual Editor with Suggestion Mode enabled, there is a misalignment between the "Help" button and the “View suggestions” one. This task is for:

  1. Standardizing spacing to 16px for both "View suggestions" and "Help" buttons
  2. Use the neutral normal Button for "Help" to differentiate it from the "View suggestions" one

image.png (6,812×2,366 px, 860 KB)

References

Event Timeline

Hi! I'd like to work on this task. I wasn't able to reproduce the issue in the regular VisualEditor interface. Could you please let me know how to enable Suggestion Mode or reproduce this issue locally? Thanks!

Hey there, thanks! You can turn the beta feature on in Preferences > Beta Features > Suggestion Mode.

Then to see the issue, you need to visit an article where no suggestions are visible at the top of the article, which causes the 'View Suggestions' button to be at the bottom. For example: https://en.wikipedia.org/w/index.php?title=Memphis,_Tennessee&action=edit

ppelberg added a project: Editing-team.
ppelberg moved this task from Untriaged to Editing-2026-2027 on the Editing-team board.
ppelberg subscribed.
ppelberg renamed this task from Visual Editor/Suggestion Mode: 'Help' and 'View Suggestions' buttons are misaligned to Resolve tension between prominence of 'Help' and 'Suggestion Mode'.Wed, Aug 5, 5:05 PM
ppelberg updated the task description. (Show Details)
bmartinezcalvo subscribed.

As decided in yesterday's editing meeting, the minimum changes we can to for the help button to stop competing with the suggestions elements is:

  1. Standardizing spacing to 16px for both "View suggestions" and "Help" buttons
  2. Use the neutral normal Button for "Help" to differentiate it from the "View suggestions" one

image.png (6,812×2,366 px, 860 KB)

In the future, if these changes are not enough we can find better improvements for the help button. But for now we could start implementing those changes.

As an additional change from the ones listed above, I wonder if we could hide the Help on mobile when a bottom sheet is displayed, so we avoid the Help button to be visible when interacting with suggestions bottom sheets and to avoid as well too many elements to be visible at the same time (e.g. when interacting with a Link bottom sheet).

Captura de pantalla 2026-08-11 a las 12.48.06.png (377×667 px, 120 KB)
Captura de pantalla 2026-08-11 a las 12.49.03.png (375×668 px, 92 KB)
Captura de pantalla 2026-08-11 a las 12.50.18.png (375×669 px, 112 KB)
Suggestion's bottom sheetCitation addedLink bottom sheet

As an additional change from the ones listed above, I wonder if we could hide the Help on mobile when a bottom sheet is displayed, so we avoid the Help button to be visible when interacting with suggestions bottom sheets and to avoid as well too many elements to be visible at the same time (e.g. when interacting with a Link bottom sheet).

Captura de pantalla 2026-08-11 a las 12.48.06.png (377×667 px, 120 KB)
Captura de pantalla 2026-08-11 a las 12.49.03.png (375×668 px, 92 KB)
Captura de pantalla 2026-08-11 a las 12.50.18.png (375×669 px, 112 KB)
Suggestion's bottom sheetCitation addedLink bottom sheet

This is probably for @AAlhazwani-WMF and @KStoller-WMF to say when they are back, but I don't think that this works in that generality ("on mobile when a bottom sheet is displayed"). GrowthExperiments uses that bottom-sheet for its structured tasks, and the help button serves as the way to get back to the documentation for that task.

Maybe it is not needed in those situations either, I'm not sure if we have usage or impact data. But if we decide to hide the button in these circumstances as well, then that would imply additional changes being necessary.

As an additional change from the ones listed above, I wonder if we could hide the Help on mobile when a bottom sheet is displayed, so we avoid the Help button to be visible when interacting with suggestions bottom sheets and to avoid as well too many elements to be visible at the same time (e.g. when interacting with a Link bottom sheet).

Could we break this into a separate task and wait until Amin returns to finalize a decision on this? I'm open to simplifying, but I want to be sure we are thinking about how this change could impact other experiences (like Suggested Edits / Structured Tasks).