Page MenuHomePhabricator

Clean up descriptions of fields in included common schemas in mediawiki/event-schemas repository
Closed, ResolvedPublic5 Estimated Story Points

Description

We recently switched to using jsonschema-tools and including common schemas via $ref pointers. In this process, it seems some description fields were not abstracted and can be confusing when read in dereferenced materialized context. E.g. the performer field in mediawiki/common has

user_edit_count:
  description: >
    The number of edits this user has made at the time this revision is created.
    Not present for anonymous users.

performer is included in many mediawiki schemas, including some that have nothing to do with revisions.

We should take a pass over existing common schemas and make sure all the field descriptions make sense in a general context.

Event Timeline

Change 538287 had a related patch set uploaded (by Ottomata; owner: Ottomata):
[mediawiki/event-schemas@master] Clarify common field descriptions

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

Change 538287 merged by Ottomata:
[mediawiki/event-schemas@master] Clarify common field descriptions

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

Nuria set the point value for this task to 5.