Page MenuHomePhabricator

Allow to provide outlines with a name to overwrite the Wikidata label one
Closed, ResolvedPublic1 Estimated Story Points

Description

As part of the Article Guidance work (T414409), communities can define outlines that capture guidance for the creation of specific types of articles. Currently, outlines get their name from the Wikidata item that they are associated with. For example, for biographies, an outline connected with "Q5" will be represented in the list of outlines as "Human". Communities may have established terms and style practices that encourage the use of a different name, but there is no way to support it currently.

This task proposes a creation of a mechanism (e.g., an optional "name" parameter) that allows to set a name for the outline. When it is set, the outline will be listed using such name. When it is missing, the Wikidata-based name can be used.

This task was created based on input from this talk page message.


NOTE: this was implemented using a label attribute.

Example: <article-guidance article-type="Q99" label="Golden state">

Event Timeline

Pginer-WMF triaged this task as Medium priority.

Change #1298792 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ArticleGuidance@master] Allow custom label to override wikidata label

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

SBisson updated the task description. (Show Details)
SBisson moved this task from In-progress to Needs Code Review on the LPL Hypothesis board.

Change #1298792 merged by jenkins-bot:

[mediawiki/extensions/ArticleGuidance@master] Allow custom label to override wikidata label

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

It would be useful to be able to overwrite the description as well. When selecting the metaclass entity to match everything, we can now overwrite the label to indicate that this is a general outline, but the unrelated description "class which has instances that are all themselves classes" makes it really confusing for the user.

Screenshot_2026-06-15-07-15-23-112_com.opera.browser.jpg (1,080×2,400 px, 352 KB)

A pending aspect is to update the markup documentation in this page.
It would be good to inform of this capability as we communicate with communities. For example, outlines associated with Q5 are currently labelled as "human" and communities can provide a more common name such as "People" or "Biography" on their wiki.

CC: @UOzurumba, @GGalofre-WMF

A pending aspect is to update the markup documentation in this page.
It would be good to inform of this capability as we communicate with communities. For example, outlines associated with Q5 are currently labelled as "human" and communities can provide a more common name such as "People" or "Biography" on their wiki.

CC: @UOzurumba, @GGalofre-WMF

@Pginer-WMF, I have updated the markup documentation page.

A pending aspect is to update the markup documentation in this page.
It would be good to inform of this capability as we communicate with communities. For example, outlines associated with Q5 are currently labelled as "human" and communities can provide a more common name such as "People" or "Biography" on their wiki.

CC: @UOzurumba, @GGalofre-WMF

@Pginer-WMF, I have updated the markup documentation page.

Thanks @UOzurumba. Reading the updated documentation I see the follwoing:

Indicates a set name of an outline when there is a specific name given to an outline from the Wikipedia community. When this name is missing, the Wikidata-based name of the Article type is used. An example of this situation is: English Wikipedia has the Broad-concept article type. To create a specific outline with this name, they will use the label markup: label="Broad-concept article" instead of the article type markup: article-type="Qxx".

The description seems a bit long for a simple attribute to name the outline, and the last part seems to present the label as an alternative to the article-type property where it is not the case. Would it make sense to simplify the contents to something along these lines:

Indicates the name to be used when displaying the outline. By default, outlines are named like the Wikidata item they are associated with. The "label" property allows communities to define a different name that is more aligned with their practicces. For example, an outline for the Wikidata item Q5 ("Human") can use the "label" property to be displayed as "Biography" instead.

A pending aspect is to update the markup documentation in this page.
It would be good to inform of this capability as we communicate with communities. For example, outlines associated with Q5 are currently labelled as "human" and communities can provide a more common name such as "People" or "Biography" on their wiki.

CC: @UOzurumba, @GGalofre-WMF

@Pginer-WMF, I have updated the markup documentation page.

Thanks @UOzurumba. Reading the updated documentation I see the follwoing:

Indicates a set name of an outline when there is a specific name given to an outline from the Wikipedia community. When this name is missing, the Wikidata-based name of the Article type is used. An example of this situation is: English Wikipedia has the Broad-concept article type. To create a specific outline with this name, they will use the label markup: label="Broad-concept article" instead of the article type markup: article-type="Qxx".

The description seems a bit long for a simple attribute to name the outline, and the last part seems to present the label as an alternative to the article-type property where it is not the case. Would it make sense to simplify the contents to something along these lines:

Indicates the name to be used when displaying the outline. By default, outlines are named like the Wikidata item they are associated with. The "label" property allows communities to define a different name that is more aligned with their practicces. For example, an outline for the Wikidata item Q5 ("Human") can use the "label" property to be displayed as "Biography" instead.

@Pginer-WMF, Thanks for simplifying it. I have updated the page.