Clean up term form UI
beeradb - March 7, 2009 - 20:24
| Project: | Drupal |
| Version: | 7.x-dev |
| Component: | taxonomy.module |
| Category: | task |
| Priority: | normal |
| Assigned: | Xano |
| Status: | needs work |
| Issue tags: | Cleanup, d7uxsprint, Needs text review, UBUserTesting2009, ui-text, Usability |
Description
We need to improve the help text under the advanced fieldset for term creation. People don't understand concepts like parents, related terms, and synonyms, and the help text doesn't do a great job of helping people understand.

#1
updating tags.
#2
#3
Attached is a patch for this text. I was a little torn on weather to indicate that the inputs did not have any functionality by default, but after spending a while figuring this out myself, it seems like it might be an important piece of information.
#4
changing status to CNR. Also fixed a misspelling in the patch. Correction attached.
#5
Thanks, karschsp!
#6
wow, guys we are trying to decrease the amount of help text not increase it. I have to give this a thorough review, but few people really had trouble understanding the concept, as soon as they actually did it. So I think its save to assume, this issue although exiting might be solved by something else then a lot of help text (changing labels?)
#7
@bojhan although in general I agree with you, these are advanced features which are totally undocumented in the interface. Do you know what a synonym does? what effect it actually has on the vocabulary? I don't think these features are self explanatory.
I'm open to other ways to convey the meaning of these fields, but as is we're not doing that at all.
#8
The last submitted patch failed testing.
#9
@bojhan What would you recommend for the help text on each of those fields?
Here are my suggestions for the text. The "relationship" information is based on the correct terms for semantic relationships in controlled vocabularies. See more at: http://www.slis.kent.edu/~mzeng/Z3919/4relationship.htm
1. Parents
Relationship: hierarchical. Items will exist below (or within) the parent(s) you select.
2. Related Terms
Relationship: associative. Items will exist alongside the ones you select.
3. Synonyms
Relationship: equivalent. Items entered will behave as if they were identical to one another. Enter one term per line.
I'm not convinced it makes sense to repeat the phrase, "X has/have no core functionality, but may be extended by other modules." I think there is a better place to put this information. What if Parents and Weight were grouped, and "Related Terms" and "Synonyms" were also grouped?
#10
The problem with improving things, is that Drupal does not appear to use the advanced options without third party modules. In the opinion of the UX-2009 Sprint team it would be better to move the advanced settings (without weight perhaps) to a third party (support) module.
#11
Adding tags.
#12
Ignore last patch. We need the text a 3rd party module is necessary only once.
#13
And this patch renames "Advanced options" to "Relationships" as that is basically what it is.
#14
changing d7uxsprint tag
#15
Screenshots before and after the patch #13
before:

after:

#16
This patch removes the Identification fieldset and all redundant element descriptions. It also renames "Related terms" to "Similar terms", to prevent collision with the "Relations" fieldset and because parent terms are also related. #504078: Synonym collapsing in core adds a description to the Synonym textare explaining what it's used for.
#17
#18
The last submitted patch failed testing.
#19
Looks good, please fix the patch.
#20
Bump. Xano, still on this?
#21
Before & after.
#22
Nice. I like 'relation's here - since that's what the fieldset has, and if I don't care what relations is, I don't need to open it, whereas you can never tell with 'advanced'.
#23
Yup, agreed - good terminology.
#24
What catch said. RTBC
#25
The last submitted patch failed testing.