Page MenuHomePhabricator

Define and implement default generic outline in code for Article Guidance default behavior when no outlines exist
Open, In Progress, HighPublic8 Estimated Story Points

Description

Context:

Article Guidance surfaces community-defined outlines to editors when they start a new article. When no outline exists for the editor's topic, editors currently hit a dead end at the topic matching step. No outlines also means that the workflow can't offer any guidance at all at the moment.

A default generic guidance in code would mean Article Guidance could have a some generic guidance implicit in the code that would be available upon activation. It's a minimum version of the workflow that offers some guidance that is generic to all wikis until more specific outlines are created.

If no outline exists and the workflow is activated, it would use this default generic outline until a wiki-specific generic outline is created by the community or more topic-specific outlines are created.

The default outline would be implicit, meaning it would live as translatable code strings and they would be translatable strings. They would not be customizable. If a community activates the feature and considers the default generic outline to be too generic, they can create their wiki-specific generic guidance outline. That wiki specific generic guidance outline would trump the default guidance.

This task aims at defining this default generic outline. Including the text contents and all implicit behaviours of the notability system and source validation. The idea is to work on the minmum version that makes this activable and provides a min version of guidance. Once the first version is done, we'll progressively work on improvements.

Default generic outline contents and flow breakdown

  • Title search: happens as usual
  • Wikidata results are displayed as usual
  • Outline matching: All wikidata results selection lead to the workflow using the default generic outline contents
  • Unsupported topic: this screen is dropped, as all results lead to the workflow with default generic outline contents
  • Subject unavailable? Pick a type instead: right after feature activation, this would lead to no types to choose from, as there are no outlines. Some options here are:
    • Changing "Subject unavailable? Pick a type" to something like " Subject unavailable, continue next step" and next step is sources. But this would have to be conditioned to any other outlines existing or not, when new outlines are created, we bring the manual selection screen back?
    • Still open the manual outline selection page, and add a generic guidance CTA. This would make the experience a bit strange as if there are no outlines it's an extra step for the editor to just continue, but it's the most minimum version that does not change the flow before we make more conscious decisions on this step.
    • Other longer term solution is to offer a list of potential outlines to select from, the selection would not have any effect on the user as they'd still have default generic guidance, but it would make the experience more structured. We said we'd work on this as a second phase and that for the darklaunch we'd keep it minimal, but maybe it makes sense to attempt it now?
  • Sources step: wether editor enters the flow via wikidata match or via manual selection, the next step will be sources as usual. In the sources step, we need to define:
    • Copy: This can mirror the current copy on outlines and we can propose general tips for what kind of sources work well across wikipedia
    • Sources lists to check against. This is had to be applicable to all wikis. Any available globally restricted sources lists to connect to the check? In the future, we should connect reference risk model here for a better experience. For now, it could be an encouragement to have sources beforehand.
  • Tips from the community: this could be general wikipedia guidelines. TBA.
  • Handoff to VE: Article structure that applies to any article will be hard to consolidate. Options:
    • "Start with an introduction of the topic and continue with the most relevant sections."

Scope of the task:

  • Define the above contents and flow adjustments
  • Implement the changes:
    • content as strings
    • drop UnsupportedSubject step

Event Timeline

Change #1338195 had a related patch set uploaded (by CoderAnimeshPathak; author: CoderAnimeshPathak):

[mediawiki/extensions/ArticleGuidance@master] Add generic guidance outline as default starting point

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

Vesperio_ofc subscribed.

hii,
I will be loved to work on this task...

@CoderAnimeshPathak thanks for giving this task a go. We'll take your input into account as we define this generic guidance outline. I expect we can take care of this task in a couple of weeks.

GGalofre-WMF renamed this task from Define a generic guidance outline contents that could be used as a starting point for all wikipedias to Define a default generic outline in code for Article Guidance default behavior when no outlines exist.Wed, Sep 23, 9:24 AM
GGalofre-WMF updated the task description. (Show Details)
GGalofre-WMF renamed this task from Define a default generic outline in code for Article Guidance default behavior when no outlines exist to Define and implement default generic outline in code for Article Guidance default behavior when no outlines exist.Wed, Sep 23, 12:46 PM
GGalofre-WMF updated the task description. (Show Details)
SBisson changed the task status from Open to In Progress.Thu, Sep 24, 3:10 PM
SBisson claimed this task.

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

[mediawiki/extensions/ArticleGuidance@master] Add a default generic guidance outline

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

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

[mediawiki/extensions/ArticleGuidance@master] Add messages for the default generic guidance outline

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

Revised @SBisson's proposal here https://gerrit.wikimedia.org/r/c/mediawiki/extensions/ArticleGuidance/+/1345113/1/i18n/en.json#64 added in bold here the few things I changed:

"articleguidance-default-outline-label": "General guidance",

"articleguidance-default-outline-instructions": "Wikipedia covers subjects that have received significant coverage in reliable sources that are independent of the subject. Before you write, check that such coverage exists. If it does not, the article is likely to be deleted however well it is written.

Quick considerations:

  • Summarise what independent sources say. Do not add your own analysis, opinion or conclusions.
  • Open with a short lead that says what the subject is and why it is notable.
  • Cite a source for every claim that a reader could reasonably question.
  • Write in a neutral tone. Avoid promotional language and loaded words.
  • Do not write about yourself, your employer, your family or your friends.
  • Do not copy text from other websites or books. Write it in your own words.",

"articleguidance-default-outline-recommended-source-1": "News organisations with editorial oversight and a record of fact-checking",
"articleguidance-default-outline-recommended-source-2": "Peer-reviewed academic journals and books from academic publishers",
"articleguidance-default-outline-recommended-source-3": "Books from established publishers and reference works with named editors",

"articleguidance-default-outline-discouraged-source-1": "The subject's own website, social media accounts, press releases, and sponsored content",
"articleguidance-default-outline-discouraged-source-2": "Blogs, forums, and other self-published material",
"articleguidance-default-outline-discouraged-source-3": "User-generated wikis, including Wikipedia itself",
"articleguidance-default-outline-discouraged-source-4": "Sources that only mention the topic in passing without substantive coverage", (I would add this one)

"articleguidance-default-outline-preload": "[Start with a short introduction: who or what the subject is and why it is notable.]\n\n[Continue with the most relevant aspects of the topic, each supported by a source.]\n\n== References ==\n\n<references>\n$1\n</references>",

Up for discussion, If we're able to, maybe it'd be useful to add the links to some of these policies for each claim. They are available in many languages, maybe we could link each appropriate language if we find this valuable.

https://en.wikipedia.org/wiki/Wikipedia:Notability
https://en.wikipedia.org/wiki/Wikipedia:Reliable_sources
https://en.wikipedia.org/wiki/Wikipedia:Independent_sources
https://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view
https://en.wikipedia.org/wiki/Wikipedia:Lead_section
https://en.wikipedia.org/wiki/Wikipedia:Verifiability
https://en.wikipedia.org/wiki/Wikipedia:Conflict_of_interest
https://en.wikipedia.org/wiki/Wikipedia:Copyrights
https://en.wikipedia.org/wiki/Wikipedia:Citing_sources
https://en.wikipedia.org/wiki/Wikipedia:Writing_better_articles
https://en.wikipedia.org/wiki/Wikipedia:What_Wikipedia_is_not

Change #1345113 merged by jenkins-bot:

[mediawiki/extensions/ArticleGuidance@master] Add messages for the default generic guidance outline

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

Change #1338195 abandoned by CoderAnimeshPathak:

[mediawiki/extensions/ArticleGuidance@master] Add generic guidance outline as default starting point

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

Change #1344761 merged by jenkins-bot:

[mediawiki/extensions/ArticleGuidance@master] Add a default generic guidance outline

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

Nikerabbit raised the priority of this task from Medium to High.Thu, Oct 8, 10:50 AM