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.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

beeradb’s picture

Issue tags: +Usability, +UBUserTesting2009

updating tags.

yoroy’s picture

Issue tags: +Needs text review
chrisshattuck’s picture

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.

karschsp’s picture

Status: Active » Needs review
FileSize
2.24 KB

changing status to CNR. Also fixed a misspelling in the patch. Correction attached.

chrisshattuck’s picture

Thanks, karschsp!

Bojhan’s picture

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?)

beeradb’s picture

@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.

Status: Needs review » Needs work

The last submitted patch failed testing.

emmajane’s picture

@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?

berenddeboer’s picture

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.

berenddeboer’s picture

Issue tags: +ui-text, +#d7uxsprint

Adding tags.

berenddeboer’s picture

FileSize
2.25 KB

Ignore last patch. We need the text a 3rd party module is necessary only once.

berenddeboer’s picture

FileSize
2.46 KB

And this patch renames "Advanced options" to "Relationships" as that is basically what it is.

seutje’s picture

Issue tags: -#d7uxsprint +d7uxsprint

changing d7uxsprint tag

eigentor’s picture

FileSize
51.17 KB
45.67 KB

Screenshots before and after the patch #13

before:

after:

Xano’s picture

Issue tags: -Cleanup
FileSize
3.35 KB

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.

This is an alternative alternate text.

Xano’s picture

Title: Advanced fieldset under create term needs help text » Clean up term form UI
Assigned: Unassigned » Xano
Status: Needs work » Needs review
Issue tags: +Cleanup

Status: Needs review » Needs work
Issue tags: +Cleanup

The last submitted patch failed testing.

Bojhan’s picture

Looks good, please fix the patch.

yoroy’s picture

Bump. Xano, still on this?

Xano’s picture

Status: Needs work » Needs review
FileSize
2.63 KB
catch’s picture

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'.

Bojhan’s picture

Status: Needs review » Reviewed & tested by the community

Yup, agreed - good terminology.

yoroy’s picture

What catch said. RTBC

Status: Reviewed & tested by the community » Needs work

The last submitted patch failed testing.

asimmonds’s picture

Status: Needs work » Needs review
FileSize
1.89 KB

Rerolled patch from #21

yoroy’s picture

Status: Needs review » Reviewed & tested by the community

back to rtbc

Xano’s picture

We might even want to get rid of the "Optionally (...)", because the asterisks indicate required and optional fields anyway. No commit blocker, just nitpicking.

yoroy’s picture

We'll leave it in here. Without it, the sentence reads very 'required'.

Dries’s picture

Status: Reviewed & tested by the community » Fixed

Committed to CVS HEAD. Thanks.

Dries’s picture

Status: Fixed » Needs work
FileSize
308.24 KB

The term form is pretty broken still:

tag.jpg

Dries’s picture

Priority: Normal » Critical
asimmonds’s picture

Related issue for the position of URL alias textfield: #678590: Path alias link is below submit button on taxonomy term add

Bojhan’s picture

Category: task » bug

This is a bug.

Bojhan’s picture

FileSize
36.36 KB

All we need to fix is the location of the url alias? The rest seems to been fixed, the breadcrumb is a larger issue - not meant to be fixed here.

termsaddbugged.png

Bojhan’s picture

Priority: Critical » Normal

Also, this bug isn't really critical anymore

yched’s picture

Status: Closed (won't fix) » Needs work
FileSize
17.46 KB

This form has Field API 'fields'. The order is defined by the admins on admin/structure/taxonomy/%tid/fields.

Reordering doesn't play nice when there are fixed-weight items in the middle of user-reorderable items.
So the consequence for other, non-Field elements in the form is that :

a) Either they declare themselves as 'reorderable' as well, using hook_field_extra_fields(). They just provide a default weight.
That's the case of 'Name' and 'Description' : see taxonomy_field_extra_fields(), and the result on this screenshot.

Should be done only if we see value in letting users tweak their position. Having too much stuff available for reordering only adds confusion for users.
I'm not sure this is the case for 'URL alias' and the 'Relations' fieldset.

b) Or they stick with a fixed position at the bottom of the form, with a reasonably high weight (100+) so that they stay out of the range of weights of the reorderable items
That's what the buttons container does.

Currently, 'url alias' has an implicit fixed weight of 0 (path_form_taxonomy_form_term_alter()), and 'Relations' has a fixed weight of 10. Both are wrong.

Dave Reid’s picture

I think its perfectly reasonable to let users re-order fields whenever they want. For the URL alias field, see #687994: Add hook_field_extra_fields() implementation to path module

Bojhan’s picture

Status: Needs work » Closed (won't fix)

Won't fix it is then?

yched’s picture

Status: Needs work » Closed (won't fix)

Won't fix it is then?

Not yet. See my reply in #687994-7: Add hook_field_extra_fields() implementation to path module.

At any rate, "something" needs to be done for 'URL alias' and 'Relations'. Either a) or b) from #37 above.

Xano’s picture

Assigned: Xano » Unassigned