Page MenuHomePhabricator

Change label "Basic form" to something clearer
Open, MediumPublic

Description

The Citoid-enabled manual citation tab offers an option "Basic form". This label is confusing, because it sounds like you will be given an actual form to fill out, rather than a large, blank, freeform box.

Can we change it to match visualeditor-dialogbutton-reference-tooltip ("Basic")?

Example:

Event Timeline

Whatamidoing-WMF raised the priority of this task from to Needs Triage.
Whatamidoing-WMF updated the task description. (Show Details)
Jdforrester-WMF renamed this task from Change "Basic form" to "Basic" to Change label in "Basic form" to "Basic".Aug 11 2015, 6:42 PM
Jdforrester-WMF set Security to None.
Jdforrester-WMF added a subscriber: Jdforrester-WMF.

The current label was the result of much searching for something that made it clear it was different from all the others. I don't think "Basic" does enough to convey that.

Non-standard? Non-template? Freeform?

Jdforrester-WMF triaged this task as Medium priority.Aug 11 2015, 7:04 PM
Jdforrester-WMF moved this task from To Triage to Freezer on the VisualEditor board.

Aside from the best name, would it be possible to separate this function from the other "regular" templates with a horizontal divider line between "Basic form" and the rest of the templates? This would clarify visually: "Basic" is a citation, but it's a different type - separate from the others.

Aside from the best name, would it be possible to separate this function from the other "regular" templates with a horizontal divider line between "Basic form" and the rest of the templates? This would clarify visually: "Basic" is a citation, but it's a different type - separate from the others.

Definitely. Have filed T108725: Show separation between template and 'basic' citation types in the "manual" tab for that.

Mvolz moved this task from Backlog to Extension on the Citoid board.Aug 12 2015, 8:44 AM

As a German I don't know how common the term is, but how about "Free-form"?
The problem with "Basic" in this context is: this citation form is not restricted to "basic" usage (aka simple or generic), in fact it can be the most complex method with additional options and flexibility in citation creation.

As a German I don't know how common the term is, but how about "Free-form"?

Hmm. Possibly.

The problem with "Basic" in this context is: this citation form is not restricted to "basic" usage (aka simple or generic), in fact it can be the most complex method with additional options and flexibility in citation creation.

"Basic" is not to mean "simplified" so much as "unstructured", "without help", "formless". I don't like the word either. :-)

Jdforrester-WMF changed the task status from Open to Stalled.Aug 26 2015, 8:25 PM

Marking as 'stalled' until someone comes up with some good wording.

Mvolz renamed this task from Change label in "Basic form" to "Basic" to Change label "Basic form" to something clearer.Sep 9 2015, 11:35 AM
Aklapper changed the task status from Stalled to Open.Aug 15 2020, 2:56 PM

"Freetext form".

The word "Basic" is not the main problem. The word "form" is the main problem. The user is not inserting a form, but a reference or a footnote. Therefore, replacing "form" with "reference" or "footnote" will make everything much clearer.

"Basic" can perhaps be replaced, too. For example, "Free-form reference" or "Generic footnote" can work. But the minimal change to "Basic reference" is probably enough.

The above is a theory. It can be proven wrong or write with a bit of user testing :)

I agree with @Amire80 - the issue here is really the word "form". If we were in an universe where the term "template" wasn't such a loaded word, I'd suggest "Basic Template".

iamjessklein updated the task description. (Show Details)Sep 3 2020, 7:20 PM

"Blank box"? "Empty"? "Create your own"?

  • Free text
  • Simple
  • Plain

How does this ticket get resolved? cc @JTannerWMF

Mvolz added a subscriber: Mvolz.Wed, Sep 30, 1:05 PM

I agree with @Amire80 - the issue here is really the word "form". If we were in an universe where the term "template" wasn't such a loaded word, I'd suggest "Basic Template".

Yeah, more accurate would even be "No template" since all the other ones ARE templates!

I actually think either

  • Other

or

  • Advanced

Both work here. You can use the "simple" box to just type the template in, sure, but you can also use it to directly insert other citation templates. It's actually more featured / complex than the other dialogs that go directly to a form.

I think "Other" captures the idea that you might want to use this option if none of the pre-sets work for you, whether you want to type in free text, use a different template than those listed, or use multiple templates.