User story & summary:
As a newcomer trying Revise Tone for the first time, I want the suggestions I'm shown to be as accurate as possible, so that my edit is more likely considered productive and not reverted.
As a experienced editor or patroller reviewing edits, I want Revise Tone suggestions to be suppressed in sections where non-neutral language is intentional, so that I am not spending time reverting edits and feeling frustrated about Revise Tone suggested edits.
Background & research:
- Feedback from enwiki discussion
- Revise tone task should avoid suggestions within plot summaries. (Example Diff)
The Tone Check model currently evaluates article text with limited regard to which section that text sits in. Some sections are poor candidates for tone suggestions because non-neutral-sounding language in them is either expected, sourced to someone else, or not prose at all. Suggestions in those sections are noise: they cost newcomers time, and rejecting or acting on them can produce edits that experienced editors need to revert.
Potential sections that could be candidates to exclude:
- Sections that consist of quoted or attributed opinion, where the non-neutral language belongs to the source rather than the article (e.g. "Reception", "Critical response", "Reviews", "Quote", "Quotation", "Text") (see also: T411892)
- Plot summaries ("Plot", "Plot summary", "Synopsis", "Story", "Legend")
- Sections that are lists or metadata rather than prose (e.g. "Discography", "Filmography", "Awards", "Bibliography")
- Reference and appendix sections ("References", "Notes", "External links", "See also", "Further reading")
Proposed Solution
Add a per-wiki configurable list of section titles that Revise Tone skips when generating suggestions, or surfacing suggestions in the Suggested Edits feed.
Implementation is TBD, but the closest precedent is the "Add a Link" setting:
Acceptance Criteria:
TBD: Needs discussion with engineers to determine approach and acceptance criteria.
Given [preconditions]
When [user action]
Then [outcome resulting from actions taken in the when clause]
All tasks should also meet the Growth Team’s task completion definition.
