Page MenuHomePhabricator

Reconsider the terminology around citations, references and footnotes in VisualEditor
Open, NormalPublic

Description

The VisualEditor UI messages feel confusing and inconsistent to me when it comes to citations, references and footnotes.

The "Cite" menu, for example. In essence, it inserts a footnote. It's not necessarily a citation or a reference. I understand the desire to have terminology that is more about functionality (citation, reference), and less about the form (footnote), but it's still a problem.

Another problem is that a "citation" is not necessarily a source reference. A citation can be a synonym of "quote" - not necessarily a source reference, but the quote itself.

Translating this to other languages complicates things even further, of course. In some languages "quote" and "cite" is the same word, which doesn't have anything to do with neither "source" nor "footnote". That word can also be confused with names of unrelated templates that already exist in that language.

One last issue I can think of now is that sometimes people will want to insert a source reference template, but not as a footnote. They can, of course, do it using the usual template insertion interface, but it seems to me that it misses the point (task T55590 comes to mind).

I don't have a silver bullet solution, but for starters, I'd suggest going over all the messages and making sure that "reference" and "citation" are used consistently. My current impression is that it's not the case. After that a terminology discussion should start, and involve the current editing communities in different languages. I believe that a reasonable baseline terminology can be found that would be translatable to all languages.

Event Timeline

Amire80 created this task.Jan 1 2015, 9:59 PM
Amire80 raised the priority of this task from to Needs Triage.
Amire80 updated the task description. (Show Details)
Amire80 added projects: VisualEditor, I18n.
Amire80 added subscribers: Amire80, Nemo_bis, Jdforrester-WMF and 3 others.

see also: T72439: Use consistent terminology on WikiEditor and VisualEditor (bonus: same icons)

Jdforrester-WMF triaged this task as Low priority.
Jdforrester-WMF set Security to None.
Neil_P._Quinn_WMF renamed this task from reconsider the terminology around citations, references and footnotes in VisualEditor to Reconsider the terminology around citations, references and footnotes in VisualEditor.Jun 5 2015, 1:13 AM
Neil_P._Quinn_WMF lowered the priority of this task from Low to Lowest.
Neil_P._Quinn_WMF removed Neil_P._Quinn_WMF as the assignee of this task.Dec 11 2015, 10:31 PM