Page MenuHomePhabricator

Promote citationNeeded out of experimental
Open, Needs TriagePublic

Description

The citationNeeded check behaves much like the addReference check, but with slightly tweaked copy:

image.png (310×183 px, 13 KB)

image.png (310×161 px, 12 KB)

Open questions

  • 1. What policy/guideline(s) should be linked within the Suggestion Card?

Meta

  • Link to relevant wish, policy, guideline, template, etc. that demonstrates volunteers have reached consensus about the validity of the issue and way(s) to address it: #TODO!
  • Suggestion scope: All Wikipedia articles (across Wikipedias) where {{citation needed}} is used

Requirements

Meta

  • Default configuration
    • maximumEditcount: N/A
    • minimumEditcount: N/A
    • Type: Suggestion
  • Detection heuristic: presence of {{citation needed}}

User experience

  • Card design
    • Title: Citation needed
    • Description (≤2 sentences): An editor has indicated that this claim needs a citation to a reliable source. Help readers understand where this information is coming from by adding one.
    • Calls to action
      • Add a citation: Open citoid
      • Dismiss: Close suggestion card
  • Success toast: Thank you for helping to make Wikipedia a resource people can rely on.
  • Card focus: when you tap/click on the suggestion, only the card should be in focus. At present, the "Citation context" item also appears and it should not.:
    image.png (2,376×764 px, 601 KB)

Instrumentation
As with all Edit Checks and Suggestions, we will want to know:

  • Any time a Suggestion of this type is activated within an edit session
  • Any time someone views a Suggestion of this type within an edit session
  • Any time someone engages with a Suggestion and how they engage with it

Background

It triggers on any {{citation needed}} template on wikis suitably configured (T427520), and suppresses any addReference check in that paragraph, so we don't duplicate the request for a citation.

The check provides a stronger, more specific signal that a reference is needed, as it has been manaully annotated by another user.

Event Timeline

Change #1307153 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] Take citationNeeded EditCheck out of experimental

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

Next steps

  • Define policy/guideline(s) to link within card.

Next steps

  • Define policy/guideline(s) to link within card.

addReference check has no links either. If we are adding links and cleaning up messages maybe that can be done in a follow up (e.g. T431375)?

  • Card design
    • Title: Citation needed
    • Description (≤2 sentences): An editor has indicated that this claim needs a citation to a reliable source. Help readers understand where this information is coming from by adding one.
    • Calls to action
      • Add a citation: Open citoid
      • Dismiss: Close suggestion card

This text comes from popup, so any changes would create two slightly different versions of the message. Should this be addressed in T431375?

  • Success toast: Thank you for helping to make Wikipedia a resource people can rely on.

Add-ref already has a message "Thank you for adding a citation!" - we should use the same message for both checks.

  • Card focus: when you tap/click on the suggestion, only the card should be in focus. At present, the "Citation context" item also appears and it should not.:
    image.png (2,376×764 px, 601 KB)

This is a bit complicated, we have two products here that are conflicting with each other. The popup (Citation context) is an EditCheck-like suggestion but predates it. We could try to suppress the popup when the suggestion is visible (that would remove the generic template 'Edit' button, and the copy/delete buttons on mobile but these are all probably rarely used).
What happens also if the user dismisses the suggestion? The popup will still show as it is unconditional. What if the user toggles off suggestions?

Change #1308073 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/Cite@master] CitationNeededContextItem: De-conflict with EditCheck

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

Change #1308075 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] CitationNeededEditCheck: Check getMatchedTool directly

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

Change #1308075 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] CitationNeededEditCheck: Check getMatchedTool directly

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

Change #1308073 merged by jenkins-bot:

[mediawiki/extensions/Cite@master] CitationNeededContextItem: De-conflict with EditCheck

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

Change #1307153 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Take citationNeeded EditCheck out of experimental

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

⚠️ For the template popup, it looks different from what the task description adds.

image.png (3,386×638 px, 234 KB)