This task involves the work of reviewing all of the Edit Suggestion UI copy before the Suggestion Mode is offered as a Beta Feature at all Wikipedias (T415320) so that we can be relatively confident the strings we will be asking volunteers to translate are stable.
Thank you to @bmartinezcalvo for identifying the need for this review.
List of suggestions types to review
- ConvertReference
- Disambiguation
- ExternalLink
- Reference Check
- Tone Check
- TextMatch
- Image Caption
- Alt Text
Problem
At the moment, Suggestions do not follow a consistent copy structure across different suggestion types. As a result, when multiple Suggestions appear on the same page, they are harder to scan, compare, and understand as a set.
Proposed solution
In order to be consistent, we could apply the following structure in the cards copies:
- Title: Action oriented
- Description: Explain the issue + Eplain the benefit for readers (starting with Help readers… to highlight impact and motivation as detected during usability testing)
- Link (optional): always at the end of the description as "Learn more"
- Buttons: Primary action (verb) + Decline (to be consistent with Checks)
- Success message (if completed): Always the same message "Thank you for helping to make this section easier for people to read."
NOTE: Copies will be iterated once we decide on structure.
Open questions
- Do we want to use the same copies for checks and suggestions? If yes, we will need to apply the new copies in both check + suggestions card
Acceptance criteria
- Define the copies structure
- Propose new copies for all suggestions
- Implement new copies