From mcox@charter.net Wed Nov 14 20:27:27 2007
From: Michelle Cox <mcox@charter.net>
To: development@drupal.org
Subject: Re: [development] Taxonomy labeling changes
Date: Wed, 14 Nov 2007 14:27:07 -0600
Message-ID: <000201c826fc$ba616be0$0400a8c0@inspiron>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============6496477110518440564=="

--===============6496477110518440564==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

On 11/14/2007 2:09:58 PM, Neil Drumm (drumm@delocalizedham.com) wrote:
>Avoid use of "Taxonomy" in the UI. The overall system, despite the
>module name, is "Categories."

I took a quick peek on my site and the only place I see it called 
"Categories" is on the menu label and the title of this page:
?=admin/content/taxonomy . Note the URL to that page.  Seems to me like the 
overall system is "Taxonomy" with a half attempt to change it to 
"Categories" that failed. What's wrong with rolling it back while we think 
about what best to call it in 7?

Michelle


--===============6496477110518440564==--


From mfburdett@gmail.com Wed Nov 14 21:03:57 2007
From: mark burdett <mfburdett@gmail.com>
To: development@drupal.org
Subject: Re: [development] Taxonomy labeling changes
Date: Wed, 14 Nov 2007 13:03:43 -0800
Message-ID: <e1bd5b380711141303j41e56c3fv878da27abd098b00@mail.gmail.com>
In-Reply-To: <000201c826fc$ba616be0$0400a8c0@inspiron>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============2945550701890215907=="

--===============2945550701890215907==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

The taxonomy "help" text is so sublimely complex.  It throws around
all of the terms that site admins need to know about (taxonomy,
vocabulary, term, category, etc.) without clearly explaining how
they're used in drupal, plus lots of bonus words like thesauri and
descriptors.

--mark

http://api.drupal.org/api/function/taxonomy_help/6

The taxonomy module is one of the most popular features because users
often want to create categories to organize content by type. A simple
example would be organizing a list of music reviews by musical genre.

Taxonomy is the study of classification. The taxonomy module allows
you to define vocabularies (sets of categories) which are used to
classify content. The module supports hierarchical classification and
association between terms, allowing for truly flexible information
retrieval and classification. The taxonomy module allows multiple
lists of categories for classification (controlled vocabularies) and
offers the possibility of creating thesauri (controlled vocabularies
that indicate the relationship of terms) and taxonomies (controlled
vocabularies where relationships are indicated hierarchically). To
view and manage the terms of each vocabulary, click on the associated
<em>list terms</em> link. To delete a vocabulary and all its terms,
choose <em>edit vocabulary.</em>

A controlled vocabulary is a set of terms to use for describing
content (known as descriptors in indexing lingo). Drupal allows you to
describe each piece of content (blog, story, etc.) using one or many
of these terms. For simple implementations, you might create a set of
categories without subcategories, similar to Slashdot's sections. For
more complex implementations, you might create a hierarchical list of
categories.

For more information please read the configuration and customization
handbook <a href="@taxonomy">Taxonomy page</a>.
array('@taxonomy' => 'http://drupal.org/handbook/modules/taxonomy/')

The taxonomy module allows content to be classified into categories
and subcategories, or vocabularies and terms. Terms may be organized
in controlled vocabularies (vocabularies with multiple lists of
categories), in thesauri (controlled vocabularies that indicate the
relationship of terms), in taxonomies (controlled vocabularies where
relationships are indicated hierarchically), or in free vocabularies
(vocabularies where tags are defined during content creation). To view
and manage the terms of each vocabulary, click on the associated
<em>list terms</em> link. To delete a vocabulary and all its terms,
choose "edit vocabulary".

When you create a controlled vocabulary you are creating a set of
terms to use for describing content (known as descriptors in indexing
lingo). Drupal allows you to describe each piece of content (blog,
story, etc.) using one or many of these terms. For simple
implementations, you might create a set of categories without
subcategories. For more complex implementations, you might create a
hierarchical list of categories.

--===============2945550701890215907==--


From rob@robshouse.net Wed Nov 14 21:06:44 2007
From: Robert Douglass <rob@robshouse.net>
To: development@drupal.org
Subject: Re: [development] Taxonomy labeling changes
Date: Wed, 14 Nov 2007 22:06:25 +0100
Message-ID: <473B6351.3080706@robshouse.net>
In-Reply-To: <e1bd5b380711141303j41e56c3fv878da27abd098b00@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============8369112877567478291=="

--===============8369112877567478291==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

mark burdett wrote:
> The taxonomy "help" text is so sublimely complex.  It throws around
> all of the terms that site admins need to know about (taxonomy,
> vocabulary, term, category, etc.) without clearly explaining how
> they're used in drupal, plus lots of bonus words like thesauri and
> descriptors.
>
> --mark
>   
Right. Take this discussion to g.d.o. please, or we'll piss a lot of 
people off =)

http://groups.drupal.org/node/7132

--===============8369112877567478291==--


From drumm@delocalizedham.com Wed Nov 14 21:10:19 2007
From: Neil Drumm <drumm@delocalizedham.com>
To: development@drupal.org
Subject: Re: [development] Taxonomy labeling changes
Date: Wed, 14 Nov 2007 13:09:27 -0800
Message-ID: <418f565e0711141309w35f12f3dl5e71cbd7efcafb71@mail.gmail.com>
In-Reply-To: <000201c826fc$ba616be0$0400a8c0@inspiron>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============3221414057409741423=="

--===============3221414057409741423==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

On Nov 14, 2007 12:27 PM, Michelle Cox <mcox@charter.net> wrote:
> On 11/14/2007 2:09:58 PM, Neil Drumm (drumm@delocalizedham.com) wrote:
> >Avoid use of "Taxonomy" in the UI. The overall system, despite the
> >module name, is "Categories."
>
> I took a quick peek on my site and the only place I see it called
> "Categories" is on the menu label and the title of this page:
> ?=admin/content/taxonomy . Note the URL to that page.  Seems to me like the
> overall system is "Taxonomy" with a half attempt to change it to
> "Categories" that failed. What's wrong with rolling it back while we think
> about what best to call it in 7?

And the heading of the fieldset on node/add/{content type with more
than one vocabulary}. The name of the overall system simply is not
used a whole lot. This naming system applies for Drupal 4.5 through 5,
and may be changed for Drupal 6.

We have quite a few precedents for using different labels in UI from
what we use in the API or URLs:
- node is content
- path is URL alias
- watchdog is log
These differences happen and are okay. It would be nice to reconcile
everything, but changing a core module name, and breaking a chunk of
contributions, is harder than changing the UI label.

-- 
Neil Drumm
http://delocalizedham.com

--===============3221414057409741423==--


From catch56@googlemail.com Wed Nov 14 21:12:25 2007
From: catch <catch56@googlemail.com>
To: development@drupal.org
Subject: Re: [development] Taxonomy labeling changes
Date: Wed, 14 Nov 2007 21:10:57 +0000
Message-ID: <473B6461.2060403@googlemail.com>
In-Reply-To: <000201c826fc$ba616be0$0400a8c0@inspiron>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============4623726152032144108=="

--===============4623726152032144108==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

>I took a quick peek on my site and the only place I see it called
"Categories" is on the menu label and the title of this page:
>?=admin/content/taxonomy . Note the URL to that page.  Seems to me like
the overall system is "Taxonomy" with a half attempt to change it to
"Categories" that failed. What's wrong with rolling it back while >we
think about what best to call it in 7?
>
>Michelle

"Categories" is only used in about three places at the moment, and as
Michelle points out users are instantly exposed to the word taxonomy as
soon as they click on the menu link, let alone taxonomy/term/n and
admin/help/taxonomy which still has pre-Categories text in it. It'd be
great to direct some of the energy being expended on this thread towards
improving the help texts and documentation which currently don't apply
consistently to either pre-5.x or 6.x versions of the module.

The patch to roll it back is 1.34kb[1]. This will increase in size with
some help text changes but it's still quite a trivial process. If
alternative names are found, we'll still need an upgrade path for the
more than 2 million urls currently on the internet[2] that use it, along
with an api change across two core modules and over 60 in contrib if
it's going to be a consistent change.

[1]http://drupal.org/node/192209
[2]Results *1* - *10* of about *2,050,000* for *inurl:taxonomy/term*


Michelle Cox wrote:
> On 11/14/2007 2:09:58 PM, Neil Drumm (drumm@delocalizedham.com) wrote:
>> Avoid use of "Taxonomy" in the UI. The overall system, despite the
>> module name, is "Categories."
>
>
>
>


--===============4623726152032144108==--