References are part of Structured Data on Commons, however they are not visible to the end user and there is no interface to be able to add them. A reference (or source) is a citation that verifies the statement. A reference can be a link to a URL or an item; for example, a book. Contributors can add and manage references and readers will see the references for the statements. Currently, there is no limit to the number of references that can be added.
A statement has an Add reference button below it.
References include fields that are grouped collectively for one reference.
Qualifiers can still be added for statements.
Adding these links for background
- https://github.com/wikimedia/mediawiki-extensions-WikibaseMediaInfo
- https://www.mediawiki.org/wiki/Extension:WikibaseMediaInfo/en
As a contributor, I want to add a reference, so that I can give credence to statements on Commons.
As a contributor, I want to modify or delete statement references, so the references are correct.
As a reader, I want to see references for statements on Commons, so I know the statements have been verified.
Acceptance Criteria
Given a Contributor is on the Structured data tab
When clicking on Edit
Then Qualifiers and Add qualifier appear below the statement
And References title and Add reference appear below Qualifiers
Given a Contributor wants to add a reference
When clicking on Add reference
Then a white field with Property and a gray field appear
Given a Contributor wants to create a reference grouping
When clicking on Add under the reference
Then a white field with Property and a gray field appear under the first property
Given a Contributor wants to fill in the reference information
When the Contributor fills in the Property field AND fills in the reference in the gray field
Then the Publish Changes button is active and is blue
Given a Contributor wants to publish a reference
When the Publish Changes button is clicked
Then the reference appears below the statement
Given a Contributor wants to modify a reference
When in Edit mode and clicked in a reference field
Then the reference can be modified and the Publish Changes button is active and is blue
Given a Contributor wants to delete a reference
When in Edit mode
Then the X appears and clicking X delete the reference
Given a Reader sees a statement
Then all the references for the statement appear below the statement
Note: This feature will be released behind a feature flag so that we can test thoroughly before release.