Page MenuHomePhabricator

Rename tracking categories for consistency in WMF-deployed extensions
Closed, ResolvedPublic

Description

8 WMF-deployed extensions have a tracking category added to every page that uses the extension, and they all name them differently: https://codesearch.wmcloud.org/deployed/?q="(intersection-category|.%2B%3F-(use|tracking)-category)"%3A&files=en.json

mediawiki/extensions/Graph"Pages with graphs"
mediawiki/extensions/intersection"Pages using DynamicPageList"
mediawiki/extensions/Kartographer"Pages with maps"
mediawiki/extensions/Phonos"Pages that use Phonos"
mediawiki/extensions/RSS"Pages with RSS feeds"
mediawiki/extensions/Score"Pages which use score"
mediawiki/extensions/timeline"Pages using Timeline"
mediawiki/extensions/wikihiero"Pages using WikiHiero"

Some of these names are also not very precise or helpful for anyone who doesn't know what's a "WikiHiero", for example.

They should be renamed to use a consistent pattern, for example using the one that folks at English Wikipedia have used already: https://en.wikipedia.org/wiki/Special:TrackingCategories

mediawiki/extensions/GraphPages using the Graph extension
mediawiki/extensions/intersectionPages using the DynamicPageList extension
mediawiki/extensions/KartographerPages using the Kartographer extension
mediawiki/extensions/PhonosPages using the Phonos extension
mediawiki/extensions/RSSPages using the RSS extension
mediawiki/extensions/ScorePages using the Score extension
mediawiki/extensions/timelinePages using the EasyTimeline extension
mediawiki/extensions/wikihieroPages using the WikiHiero extension
Progress
  • mediawiki/extensions/Graph (no point since it's being archived)
  • mediawiki/extensions/intersection
  • mediawiki/extensions/Kartographer
  • mediawiki/extensions/Phonos
  • mediawiki/extensions/RSS
  • mediawiki/extensions/Score
  • mediawiki/extensions/timeline
  • mediawiki/extensions/wikihiero

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript
Bugreporter subscribed.

There are another one: Pages using DynamicPageList (intersection-category).

"The folks at the English Wikipedia" = basically just me, by the way.

MusikAnimal subscribed.

I suggest either Pppery's convention of "Pages using the N extension" or simply "Pages using N". The latter is a little more vague but still grammatically correct, given N is a capitalized proper noun, as it should be for any extension. I.e. "Pages using Score".

Some of these names are also not very precise or helpful for anyone who doesn't know what's a "WikiHiero", for example.

As a tracking category (more admin/sysadmin-oriented), I wouldn't be too concerned about it, so long as it reads well enough. "Pages using the WikiHiero extension" doesn't make sense either unless you know what an "extension" is in this context. Nonetheless, the word "extension" does help those who do know what it means, so all in all I vote for "Pages using the N extension".

Lets also not forget to document this convention at Manual:Extension registration § Tracking categories (which I just added!) and maybe also Help:Tracking categories.

I submitted gerrit change 1042961 for Extension score, before learning of this task.

Change #1042961 had a related patch set uploaded (by Aklapper; author: Skierpage):

[mediawiki/extensions/Score@master] i18n: improve score-use-category title text

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

Is it enough to simply change the en.json messages and wait for the deployment train? Or does it also need some kind of cache refreshing?

Yes, although it will take a few days or weeks until all pages are moved to the newly renamed tracking categories. This can be accelerated by purging them.

I'd be happy to merge changes here, but first I'd want someone to volunteer to write a Tech News entry and respond to any comments. Although the initial change will only affect English-language wikis (excluding English Wikipedia, which already uses these names), I would expect the changes to the source text to also lead to some changes in translations, so it seems worth announcing to the wider Wikimedia community.

EasyTimeline change is going out in Tech News now.

Timeline appears to have been renamed without any complaints I can find. Probably the others will be too.

(except for Graph, which at this point we shouldn't touch)

I've been hoping that someone would do all of them at once, so that we wouldn't have to bother translators and the communities with these changes more times than necessary.

Change #1042961 merged by jenkins-bot:

[mediawiki/extensions/Score@master] i18n: improve score-use-category title text

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

Pppery updated the task description. (Show Details)
Pppery updated the task description. (Show Details)

Change #1062199 had a related patch set uploaded (by Pppery; author: Pppery):

[mediawiki/extensions/intersection@master] Rename tracking category for consistency, update URL

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

Change #1062200 had a related patch set uploaded (by Pppery; author: Pppery):

[mediawiki/extensions/wikihiero@master] Rename tracking category for consistency

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

Change #1062201 had a related patch set uploaded (by Pppery; author: Pppery):

[mediawiki/extensions/RSS@master] Rename tracking category for consistency

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

Change #1062202 had a related patch set uploaded (by Pppery; author: Pppery):

[mediawiki/extensions/Phonos@master] Rename tracking category for consistency

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

Change #1062203 had a related patch set uploaded (by Pppery; author: Pppery):

[mediawiki/extensions/Kartographer@master] Rename tracking category for consistency

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

Change #1062200 merged by jenkins-bot:

[mediawiki/extensions/wikihiero@master] Rename tracking category for consistency

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

Change #1062203 merged by jenkins-bot:

[mediawiki/extensions/Kartographer@master] Rename tracking category for consistency

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

Change #1062201 merged by jenkins-bot:

[mediawiki/extensions/RSS@master] Rename tracking category for consistency

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

Change #1062199 merged by jenkins-bot:

[mediawiki/extensions/intersection@master] Rename tracking category for consistency, update URL

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

Change #1062202 merged by jenkins-bot:

[mediawiki/extensions/Phonos@master] Rename tracking category for consistency

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

I'm not going to bother doing graph since the extension is dead.

For Tech News, I believe this would be a suitable summary (both clear to those familiar, and with enough clues for those unfamiliar, and pointers for translators). Please tweak or suggest alternatives, if needed:

Six tracking categories have been renamed in TranslateWiki to make them more easily understood and consistent. These categories are automatically added to pages that use specialized MediaWiki extensions. The affected names are for: DynamicPageList, Kartographer, Phonos, RSS, Score, WikiHiero. Wikis that have created the category locally should rename their local creation to match.

That, plus the usual link to the task, should suffice.

I suggest adding something like "The new category names are listed at [[Special:TrackingCategories]]."