String freeze: Taxonomy text tweaks [#201344]

This is still at CNW, and I'm just uploading it here for posterity.

Taxonomy module has a fine reference to drag-and-drop, except... I guess I assumed that we couldn't reference a "left" side or "right" side of a list with potential support of RTL languages.

Currently, this says (this is an example, there are three places we'd have to fix this):
Forums is a flat vocabulary. You may organize the terms in the Forums vocabulary by using the handles on the left side of the table. To change the name or description of a term, click the edit link next to the term.

Also, while I was here, I noticed:

The taxonomy module allows you to categorize your content using both tags and administrator defined terms. It is a flexible tool for classifying content with many advanced features. To begin, create a 'Vocabulary' to hold one set of terms or tags. You can create one free-tagging vocabulary for everything, or seperate controlled vocabularies to define the various properties of your content, for example 'Countries' or 'Colours'.

We need to switch "Colours" to "Colors", and "seperate" to "separate". The "create a 'Vocabulary'" needs to refer to "Add vocabulary" rather than create, but I wasn't sure if this was suggesting to add a vocabulary named Vocabulary, or exactly what.

Comment	File	Size	Author
#5	taxonomy_help.patch	1.67 KB	catch
#5
#2	taxonomy-text-tweak.patch	1.84 KB	keith.smith
#2
	tax-help.patch	5.13 KB	keith.smith

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

Comment #1

keith.smith CreditAttribution: keith.smith commented 15 December 2007 at 23:45

Title:

Taxonomy drag and drop, and misc. other tweaks

» Taxonomy text tweaks

Prior comment implied this was an issue relative to drag-and-drop functionality, which is not the case.

Comment #2

keith.smith CreditAttribution: keith.smith commented 18 December 2007 at 23:32

Title:	Taxonomy text tweaks	» String freeze: Taxonomy text tweaks
Status:	Needs work	» Needs review

File	Size
taxonomy-text-tweak.patch	1.84 KB

Please ignore the first part of my initial post; that turned out to be a non-starter.

However...the second part I raise with some trepidation, wishing to avoid a taxonomy holy war at all costs. I'm trying to propose an alternative for this text:

which I do not find very clear.

The only alternative I can come up with is:

return '<p>'. t('The taxonomy module allows you to categorize your content using both tags and administrator-defined terms. Because taxonomy module is a flexible tool with many advanced features, it may be best to begin by <a href="@add-vocabulary">adding a vocabulary</a>, selecting the <em>Content types</em> in use on your site, and checking <em>Tags</em>. For more information on advanced uses of taxonomy module, see the <a href="@taxonomy-help">taxonomy module help</a>.', array('@add-vocabulary' => url('taxonomy/add/vocabulary'), '@taxonomy-help' => url('admin/help/taxonomy'))) .'</p>';

I do not like this proposed text (or the original) because it occupies valuable screen real estate with an instruction that may arguably only have value the first time someone goes to this page to create a new vocabulary, with no prior experience with taxonomy. However, it appears that taxonomy is hard to grok, and this tip may be helpful. I suspect that people who old friends with this page no longer read the text anyway.

Comment #3

catch

he/him

English

CreditAttribution: catch commented 19 December 2007 at 12:23

I think this is an improvement, and apologise for yet another English spelling introduced into Drupal :P

Also agree it'd be nice if this was shorter, but I don't see any way to get around that Could do with another set of eyes on it.

Comment #4

Gábor Hojtsy

he/him

Hungarian

Hungary

CreditAttribution: Gábor Hojtsy commented 19 December 2007 at 13:32

Status:

Needs review

» Needs work

I think the existing text is much more friendly on the user, providing examples, instead of pointing elsewhere to get info on some 'advanced' thing. We try to simply this, not make it more advanced looking :)

Comment #5

catch

he/him

English

CreditAttribution: catch commented 19 December 2007 at 13:51

Status:

Needs work

» Needs review

File	Size
taxonomy_help.patch	1.67 KB

Here's a quick patch to fix the mis-spelling and UK spelling (both my fault from the help text rewrite patch) which ought to be fixed whatever happens.