Page MenuHomePhabricator

Named References in VE: Determine Potential Design Options
Open, Needs TriagePublic

Description

Objectives

  • Editors want Wikitext to be readable. Having named (instead of numeric) references helps with this.
  • When using a reference at multiple places, editors want its name to be memorable.
  • When copying references from another article or a sandbox, editors don't want to deal with 'name collisions' that occur due to the numeric reference names.

Approach

  • Always auto-generate a name, but let the user edit if they like.
    • This should be done for both Automatic and Manual references
  • Provide more space in the Re-use section for the reference names (as they might be longer now)
  • Add an " Options" header to Automatic citations (similar to the one present in Manual) and show the reference name there.
Mocks
More space for named referencesAdd reference name under the Options menuAdd an Options menu is all references
Screenshot 2020-02-26 at 9.47.00 AM.png (580×564 px, 135 KB)
Screenshot 2020-02-26 at 9.47.09 AM.png (716×852 px, 151 KB)
Screenshot 2020-02-26 at 9.47.14 AM.png (772×860 px, 100 KB)

Questions

Resources


Acceptance Criteria:

  • Consult existing wish
  • Determine potential UI experience for new feature
  • Provide mockup examples of UI recommendations

Event Timeline

Prtksxna renamed this task from NRVE: Determine Potential Design Options to Named References in VE: Determine Potential Design Options.Feb 26 2020, 4:19 AM
Prtksxna updated the task description. (Show Details)
Prtksxna added subscribers: ifried, Mooeypoo.

@Aklapper Sorry, it's 'Named References in VE,' which is one of the wishes from the 2019 Wishlist. We have not launched the project yet, but we are beginning the early stages of planning & investigation. Sorry for the cryptic name!

@Prtksxna I discussed these mockups with @Mooeypoo today. In particular, we discussed the ability to edit auto-generated reference names in VE. Unfortunately, there are some technical issues. The technical work to allow such behavior would be complex and substantial; the engineers have advised against it. Most likely, it would be very time-consuming for the team. For this reason, we may need to steer clear of allowing the editing of reference names in VE. If users want to edit or change the reference names, they'll be able to do that in source editing. We should discuss this in greater detail, so I'll schedule a meeting for us to talk about it together. Thanks!

Sorry, it's 'Named References in VE,' which is one of the wishes from the 2019 Wishlist. We have not launched the project yet, but we are beginning the early stages of planning & investigation. --ifried, Feb 26 2020, 2:14 PM

@ifried: For the record, also appears to be one of the wishes from the 2017 wish list, with unanimous support. Is there an update on the status?

@Mathglot Hello! I am no longer on the Community Tech team. Questions about the status of the work can directed to the team product manager, @NRodriguez. Thanks!

@NRodriguez can you explain what the status ‘ Open, Needs Triage’ listed at the top means, and what the next steps are?

ldelench_wmf subscribed.

Removing the Community-Tech tag - we have reprioritized our work based on a new scoring process, and are in the process of cleaning up our backlog to provide a more accurate view of our focus areas this year.
For additional background, see the status report for 2019 wishlist. cc @NRodriguez

Aklapper added a subscriber: Prtksxna.

Removing task assignee due to inactivity as this open task has been assigned for more than two years. See the email sent to the task assignee on August 22nd, 2022.
Please assign this task to yourself again if you still realistically [plan to] work on this task - it would be welcome!
If this task has been resolved in the meantime, or should not be worked on ("declined"), please update its task status via "Add Action… 🡒 Change Status".
Also see https://www.mediawiki.org/wiki/Bug_management/Assignee_cleanup for tips how to best manage your individual work in Phabricator. Thanks!

I did some fiddling with this at the last hackathon, and found that it was surprisingly painful to get the internallist to change the name of a reference after it was created, for structural reasons. There's been a bunch of refactoring of Cite + the internallist in the ~6 months since then because of WMDE's subreferences work, so I should check whether that still holds true.

That said, insofar as changing the name was the problem, I should dig up that code and see how simple it is to just restrict it to setting the name on initial creation.

(Supporting changing the name of a reference is also probably gated behind T405155 (or similar), because we'd want to be able to detect if we're going to break references reused inside a template by changing the name. I don't think we're going to be able to support making that edit to the reference-in-the-template, but at a minimum we should be able to grey out the input or suchlike in order to stop a user from breaking things inadvertently.)