Page MenuHomePhabricator

Item Creation: Show examples for name/description
Closed, DuplicatePublic

Description

What users tried: People in our test were unsure what "label" and "description" mean.

image.png (757×160 px, 8 KB)

Possible solution We could show examples to make it more clear. A proper place might be the input placeholder in the input fields. Currently they repeat the label: "enter label in english", but they could give an example like "e.g. Lion" / "e.g. one of the big cats in the genus Panthera"

Event Timeline

I'd rather like us to give a clearer description than an example because from experience it'll lead to too many people just putting the example text in.
Have a look at the description editing in the Wikipedia app for wording suggestions. I've spent quite some time with them figuring this out.

clearer description

Is this the description?

image.png (779×131 px, 14 KB)

I assume people just don't read it (but it is hard to prove the nonexistence)

example because from experience it'll lead to too many people just putting the example text in.

We could A/B test that and/or just A-test and check how many people put the same words there. My guess would be if they are 1 to 1 copying the text about "Lion" (see example above) anything else they would have put there without the example would not have made much sense either… but let's test it.

Alternatively, we could consider to show label and description of showcase items in the item creation UI on demand, but this would be visually more heavvy.

thiemowmde triaged this task as Medium priority.Dec 12 2017, 8:27 AM
thiemowmde subscribed.
  • I believe repeating the word "label" in the placeholder does not help and can be removed.
  • However, we found it crucial the placeholder repeats the language.
  • What about:
    • Label:
      • How the entity is usually called (English)
    • Description:
      • Short (lower-case first) phrase to distinguish from similar entities (English)

@thiemowmde: Thanks! I'm fine with that, too. (I'd still prefer the examples a bit, but only a test could show, so we can move on with either)