VE requirement (T245299):
- As someone editing a sub-reference in VE, it should be clear you are editing a reference that has a relationship to other reference(s)
- As someone editing a sub-reference in VE, it should be clear to you what reference said sub-reference relates to.
User story:
As an editor editing a sub-reference in an article in VE
I want understand that the article is a subreference
And I want to know which reference this subreference is related to
So that I know what information is already provided by the parent reference
And so that I know what information should/could be included in the subreference
Implementation:
- pass the extends information with the reference model and display a warning when a reference is extending another one (to demo that the information is being passed through) patch
- display text of parent reference before the extends content in the VE pop up (patch) - see also T239228 and its patch
- display the text of the parent ref to the edit wizard of the sub-reference WITH the warning in the screenshot. The warning is important so that the user is alerted of what they are doing. The parent ref text is important so that the user can make a conscious decision based on what they see in the parent ref text (patch)
https://gerrit.wikimedia.org/r/1047510
edit dialog warning msg --> https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Cite/+/1051181
- make changes testable on beta
- Todo: write task for UX with review items
Review Items for UX:
- Review rendering with UX, and discuss next steps
- Should a warning be included in the sub-reference edit dialog, or is displaying only the parent reference text sufficient?
- Is the warning message with the parent reference text clearly visible?
- Is the wording of the warning message "this is an extension of another reference" easy to understand?
- Does the inclusion of the warning message enhance the editing experience?
- Can users easily differentiate between parent refs and sub-refs?
- Are there potential usability issues for users when editing a sub-reference?
- Are users with disabilities able to create and edit sub-references (eg Screenreaders, keyboard navigation)
- Are there any improvements needed to meet accessibility standards?
- Is additional contextual help required to aid users in understanding the relationship between parent and sub-references?