####User story & summary:
Project-level user story:
>As a newcomer to Wikipedia, I want to receive suggestions that help me identify and improve non-neutral language in articles so that I can make constructive contributions that align with Wikipedia’s MOS, encyclopedic tone, and neutrality standards.
Task specific user story:
>As the Growth team's Product Manager, I want to plan, run, and interpret the "Improve Tone Suggested Edit" experiment, so that we can understand how constructive edits between the treatment group and control group differs.
**Guiding Key Result**: [[ https://meta.wikimedia.org/wiki/Wikimedia_Foundation_Annual_Plan/2025-2026/Product_%26_Technology_OKRs#Contributor_Experiences_(WE1) | WE1.1 ]]: Increase constructive edits (edits that are not reverted within 48 hours of being published) for editors with less than 100 cumulative edits.
**Dependency**: {T392283}
####Project description:
This project aims to support newcomers by introducing a Suggested Edit that focuses on identifying and improving non-neutral language in articles. Specifically, it will highlight sentences that contain peacock terms, puffery, promotional language, or other wording that conflicts with Wikipedia’s policies on neutrality and encyclopedic tone.
Powered by the Machine Learning “Tone” model (formerly called the “Peacock” model), with UX that builds upon the Edit Check UI, this Suggested Edit will highlight instances of biased language and offer in-context guidance to help users rewrite a sentence in a more encyclopedic tone. The goal is to encourage constructive, policy-aligned contributions while helping newcomers build confidence and awareness of core content standards.
This work builds on the Growth team’s broader strategy to lower barriers to editing through Structured Tasks. In Q1, we aim to release a beta version to lay the groundwork for future experiments evaluating the task’s impact on newcomer contributions and the scalability of Edit Check as a foundation for Suggested Edits.
####Project-level Hypothesis:
If we provide newer editors with a Suggested Edit that highlight instances of non-neutral language or improper tone, and offer built-in guidance to rewrite with a more encyclopedic tone, then newer editors will be more likely to make constructive contributions that align with Wikipedia’s policies, while building confidence and awareness of core content standards.
####Background & research:
Writing in a neutral tone is a pillar of Wikipedia. Writing in a neutral tone is also a practice many new volunteers find to be unintuitive. An [[ https://phabricator.wikimedia.org/T371158#10254776 | October 2024 analysis ]] of the new content edits newer volunteers published to English Wikipedia found:
- 56% of the new content edits newer volunteers published contained peacock words.
- 22% of the new content edits newer volunteers published that contained peacock words were reverted
New content edits containing peacock words were 46.7% more likely to be reverted than new content edits without peacock words
[[ https://www.mediawiki.org/wiki/Edit_check/Tone_Check#Background | Edit_check/Tone_Check#Background ]]
Suggested Edits help new account holders get started editing:
- Growth’s Suggested Edits (Newcomer Tasks) increase the probability that newcomers make their first article edit (+11.6%) [[ https://www.mediawiki.org/wiki/Growth/Personalized_first_day/Newcomer_tasks/Experiment_analysis,_November_2020 | Newcomer_tasks/Experiment_analysis,_November_2020 ]]
- Structured Tasks (a type of Suggested Edit) can support newcomer activation and retention:
- “Add a Link” increases the probability that newcomers make their first article edit (+16.6% over baseline) and the probability that they are retained as newcomers (+16.2% over baseline). [[ https://www.mediawiki.org/wiki/Growth/Personalized_first_day/Structured_tasks/Add_a_link/Experiment_analysis,_December_2021 | Add_a_link/Experiment_analysis,_December_2021 ]]
- “Add an Image” increases the likelihood that mobile web newcomers make their first article edit (+17.0% over baseline), and the likelihood that they are retained as newcomers (+24.3% over baseline). [[ https://www.mediawiki.org/wiki/Growth/Personalized_first_day/Structured_tasks/Add_an_image/Experiment_analysis,_March_2024 | Add_an_image/Experiment_analysis,_March_2024 ]]
- 2025 English Wikipedia Add a Link analysis: {T382603}
####Acceptance Criteria:
[] Final QA of instrumentation before the experiment release
[] Quick check to ensure we are collecting the necessary data after the experiment release; Review experiment and instrumentation for experiment analysis.
[] Review [[ https://foundation.wikimedia.org/wiki/Legal:Data_Collection_Guidelines | Data Collection Guidelines ]] and obtain/seek L3SC approval as needed
[] Review [[ https://wikitech.wikimedia.org/wiki/Data_modeling_guidelines | Data Modeling Guidelines ]] as needed
[] Review [[ https://www.mediawiki.org/wiki/Product_Analytics/Dashboarding_Guidelines | Dashboard(ing) Guidelines ]] as needed
[] QA
[] Code Review: user data gathering, edit data gathering, analysis/modeling
[] ✨Perform analysis✨
[] Prepare [[ https://wikitech.wikimedia.org/wiki/Data_Platform/Systems/Jupyter#Quarto | Quarto ]] report
[] Report review
[] Share draft analysis
[] Review data [[ https://www.mediawiki.org/wiki/Product_Analytics/Reporting_Guidelines | Reporting guide ]] and [[ https://foundation.wikimedia.org/wiki/Legal:Data_publication_guidelines#Threshold_table | Guidelines ]] to ensure compliance
[] Review [[ https://www.mediawiki.org/wiki/Product_Analytics/Reporting_Guidelines#Publishing_reports | publishing reports guidelines ]]
[] Determine and add the appropriate license
[] Enter data publication into the data publication log form registry
[] Post notebooks to [[ https://www.mediawiki.org/wiki/GitLab | Gitlab ]]
[] Publish the Quarto report following the [[ https://wikitech.wikimedia.org/wiki/Data_Platform/Web_publication | web publishing guidelines ]] including the [[ https://www.mediawiki.org/wiki/GitLab | Gitlab ]] repo link
[] Share findings with Growth team and the Community (either via a summary in this task, or a MediaWiki page).
[] Clear all interim tables and csv files per the [[ https://foundation.wikimedia.org/wiki/Legal:Wikimedia_Foundation_Data_Retention_Guidelines | Data Retention Guidelines ]]