Page MenuHomePhabricator

Editing Suggestions - Update static descriptions.
Closed, ResolvedPublic

Description

This task involves the work of updating static descriptions of the LLM-generated MoS editing suggestions once we receive them from the Editing Team.

Requirements

NOTE: each of the static_descriptions defined below are wrapped in quotes in an effort to signal to experienced volunteers that we are asking them to evaluate whether said suggestion is valid or not. To further reinforce this point, each of these suggestion will include a "Is this suggestion valid?" prompt that will be implemented along with corresponding actions in T432666
Simplify language
Current🟢 DesiredNotes
Suggestion titleSimplify languageSimplify languageNo changes needed.
Suggestion static_description"Simplify language by keeping the meaning but making the wording clearer, shorter, or easier to read, such as replacing jargon or complex sentences with plain language."Readers might find this text difficult to understand. Try rewriting this using shorter sentences and plain language. [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary Learn more]."
NPOV
Current🟢 DesiredNotes
Suggestion titleNPOVRevise tone
Suggestion static_descriptionRe-writing sentences based on a natural point of view."Editors often revise this kind of wording, saying the tone is unbalanced. You can help by rewriting it using a [https://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view neutral point of view]."
MOS:GEO
Current🟢 DesiredNotes
Suggestion titleMOS:GEOReview place name
Suggestion static_descriptionMOS:GEO please see the description in the [guide](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Geographical_items)."This place name may not follow [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Geographical_items Wikipedia's geographical naming guidelines]. Please check that it uses the most common English name and standard formatting."

Done

Event Timeline

Hey @ppelberg, just checking in—are you still planning to update the static descriptions? If not, would it make sense to close this ticket?

OKarakaya-WMF changed the task status from Open to Stalled.Jun 30 2026, 1:55 PM

I think we can create a new ticket when we have the descriptions and update accordingly.
Therefore, I'm closing this ticket but please feel free to share the descriptions and we can always reopen this task e.g. in scope of bug fixing etc.

ppelberg updated the task description. (Show Details)

Hey @ppelberg, just checking in—are you still planning to update the static descriptions? If not, would it make sense to close this ticket?

@OKarakaya-WMF: Ok! The task description now includes the copy updates Editing would value y'all (ML) making to the suggestion titles and copy.

Can you please let me know what (if any) questions/concerns the proposal brings to mind of you?

And in the meantime, thank you for being incredibly patient with me!

Per the cross-team discussion we had on 30 June 2026, we're going to reframe these LLM-generated MoS suggestions, during the evaluation phases (1 & 2), as being explicitly about asking experienced volunteers to remark on whether they think these suggestions are reliable or not.

In service of the above, I've updated the copy.

Meta: moving to Ready for sign off while we await ML implementation.

Change #1315748 had a related patch set uploaded (by Ozge; author: Ozge):

[operations/deployment-charts@master] ml-services: Bump editing-suggestions model to updated MoS copy

https://gerrit.wikimedia.org/r/1315748

Updated as follows with a small typo fix in npov.

"simplify_language": {
    "title": "Simplify language",
    "static_description": "Readers might find this text difficult to understand. Try rewriting this using shorter sentences and plain language. [Learn more](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary)."
},
"NPOV": {
    "title": "Revise tone",
    "static_description": "Editors often revise this kind of wording, saying the tone is unbalanced. You can help rewriting it using a [neutral point of view](https://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view)."
},
"MOS:GEO": {
    "title": "Review place name",
    "static_description": "This place name may not follow [Wikipedia's geographical naming guidelines](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Geographical_items). Please check that it uses the most common English name and standard formatting."
},

Change #1315748 merged by jenkins-bot:

[operations/deployment-charts@master] ml-services: Bump editing-suggestions artifact to updated MoS copy

https://gerrit.wikimedia.org/r/1315748

The static_description and the titles are updated as suggested 🎉

image.png (1,382×956 px, 202 KB)

I'm closing the ticket.

DLynch subscribed.

Sorry, I wasn't paying attention to this ticket as it was happening. The links that were created are in markdown format, and they should be in wikitext format.

e.g. [Learn more](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary should be [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary Learn more] (or [[Wikipedia:Manual_of_Style#Vocabulary|Learn more]] if you happen to know for sure it's a same-wiki link, but I wouldn't bother for this case).

Sorry, I wasn't paying attention to this ticket as it was happening. The links that were created are in markdown format, and they should be in wikitext format.

e.g. [Learn more](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary should be [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Vocabulary Learn more] (or [[Wikipedia:Manual_of_Style#Vocabulary|Learn more]] if you happen to know for sure it's a same-wiki link, but I wouldn't bother for this case).

Good spot, @DLynch. Could you please give the updates I made to the task description in T430030#12200459 a quick review to make sure everything looks good before we ask @OKarakaya-WMF to implement them?

achou reopened this task as Open.

@ppelberg Those look correct, yes. I made a minor edit to the grammar in NPOV.

@ppelberg Those look correct, yes. I made a minor edit to the grammar in NPOV.

Wonderful. Thank you, @DLynch.

@OKarakaya-WMF, assigning this back over to you to implement the copy tweaks!

gkyziridis opened https://gitlab.wikimedia.org/repos/machine-learning/exploratory-notebook/-/merge_requests/17

edit_suggestions: Update the latest changes in the descriptions in static_descriptions notebook

gkyziridis merged https://gitlab.wikimedia.org/repos/machine-learning/exploratory-notebook/-/merge_requests/17

edit_suggestions: Update the latest changes in the descriptions in static_descriptions notebook

Change #1327072 had a related patch set uploaded (by Gkyziridis; author: Gkyziridis):

[operations/deployment-charts@master] ml-services: Deploy latest editing-suggestions on experimental staging and prod

https://gerrit.wikimedia.org/r/1327072

Change #1327072 merged by jenkins-bot:

[operations/deployment-charts@master] ml-services: Deploy latest editing-suggestions on experimental staging and prod

https://gerrit.wikimedia.org/r/1327072

Update

The latest changes following the updates on the descriptions for the editing-suggestions are merged and deployed on staging and prod.
The updated csv file with the latest descriptions can be found here
Here are the pods running:

$ kube_env experimental ml-staging-codfw
$ kubectl get pods
NAME                                                             READY   STATUS    RESTARTS   AGE
editing-suggestions-predictor-00004-deployment-c44b669b8-s4sxb   3/3     Running   0          2m59s

$ kube_env experimental ml-serve-eqiad
$ kubectl get pods
NAME                                                              READY   STATUS    RESTARTS   AGE
editing-suggestions-predictor-00009-deployment-5dc984bc6f-bdr2g   3/3     Running   0          2m29s

$ kube_env experimental ml-serve-codfw
$ kubectl get pods
NAME                                                              READY   STATUS    RESTARTS   AGE
editing-suggestions-predictor-00008-deployment-78b847f564-7r4gc   3/3     Running   0          2m35s

Confirmed that the links are fixed:

CleanShot 2026-08-19 at 10.01.13@2x.png (642×826 px, 91 KB)