T360489 will introduce a new "Suggestion Mode" within VE. This task involves the work of introducing a way for someone encountering a suggestion to offer feedback about it. E.g. when they detect a false positive or a suggestion being presented when they don't think it ought to be.
Story
- As an experienced volunteer who opted into seeing suggestions for changes I could consider making while editing within the Visual Editor, I'd value being able to make the person/people responsible for the particular Suggestion I'm seeing aware when I think it is being shown when/how it shouldn't be, so that I can ensure the Suggestions that are shown are useful/aligned with consented upon policies and guidelines.
- As a member of the Editing Team motivated to introduce Edit Suggestions that volunteers find compelling and constructive and to feel empowered to do so in a lightweight and experimental way, I'd like to be able to see, at a glance, the proportion of suggestion mode edit sessions a suggestion type was shown within and the proportion of times that suggestion was acted upon or dismissed.
- As a technical volunteer motivated to create new suggestions and refine existing ones, I'd value there being a way for me to easily propose (or, in some cases, directly make a change) to a suggestion I received while editing so that I can a) ensure we are presenting suggestions that, if acted upon, will benefit Wikipedia and the people who depend on it to learn and b) contribute to a culture that releases software early and often knowing there is a community of volunteers who will help me refine it over time.
- This particular story surfaced in response to the work Editing is doing on T409484 wherein it would be wonderful if we could release a first iteration and know that volunteers at wikis like de.wiki and ru.wiki will adapt the baseline implementation of the suggestion to align with the "AI tells" volunteers at each project have been collectively tracking. 1 2
Requirements
- A CTA should appear on each Edit Suggestion card
- Upon tapping, people should see a text field where they can input the feedback they are wanting the developers to see without needing to leave where they are.
- TBD what (if any) feedback prompt(s) should appear on this form. See "Open question #3" below.
- Each piece of submitted feedback should be automatically accompanied by:
- RevisionID of the article the suggestion was surfaced on/in
- The type of suggestion
- Username of the person submitting feedback
- The span of content that caused the Suggestion to be shown
- All feedback should be automatically ≠published to a centralized page on mediawiki.org: [[mw:Talk:VisualEditor/Suggestion_Mode/Feedback]]
- Note: [[mw:VisualEditor/Suggestion_Mode/Feedback]] will redirect to [[mw:Talk:VisualEditor/Suggestion_Mode]].
- Upon submitting feedback form, present people with a message that informs them:
- Feedback has successfully been submitted
- Where they can go to see this feedback
- How they can receive updates about when the feedback they shared is responded to
- The visibility of the feedback CTA needs to be configurable so that we preserve ourselves the space to, in the future, only show it to people with a min. edit count
Mockups
| Mobile | Desktop |
|---|---|
Open question(s)
- 1. How – if at all – will this feedback be made available on-wiki?
- Per requirements: "All feedback should be automatically ≠published to a centralized page on mediawiki.org: [[mw:Talk:VisualEditor/Suggestion_Mode/Feedback]]".
- 2. What would need to be true/available for us to be able to relate a "decline" to the article revision and specific span of text the suggestion was surfaced in relation to?
- 3. What (if any) prompt(s) will accompany the feedback form/text field?
References
- Perhaps previous work on Edit Check decline surveys could be useful here: T389443, T381610, etc.
- Engvar user script notes via @Quiddity
- VE feedback form:
- VE feedback form success:
Acceptance criteria or Done
- Design:
- Explore solutions for the best placement for this new feedback button in the suggestion's card
- Define the copy for CTA + Dialog
- Design the flow
- Decide on best approach
- Implement decided solution
Thank you to @Sdkb for prompting this idea.








