Taxonomy module needs updated admin help page

I wasn't sure if I should jump in and write a patch, as oyu might be working on one, Emma Jane?

Currently, with the default 'tags' vocabulary, it is quite unclear what 'term' means and that 'tagging' can be added to any vocabulary.

I suggested chunking a description of the basics of Vocabulary, and a comparison of Admin-defined terms versus user-defined tags. As well, anything about extending at the end.

There is a mixing of metaphors with a 'cooking' metaphor in the help page, and 'music' on the docs page. I prefer the music metaphor, and honestly, I didn't grok the cooking metaphor after a few times reading it.

Do you want me to make this a patch?

Taxonomy help

The taxonomy module allows you to categorize content using various systems of classification for maximum flexibility.

Vocabulary

A vocabulary allows administrators to define a system for classification of content. Each vocabulary consists of a set of terms. Add vocabulary

Music Genre would be an example of a vocabulary; and rock, jazz and classical would be an example of terms in that Vocabulary. You could allow for users to submit the terms using a 'tagging' approach, or you could pre-define those terms.
You can have multiple vocabularies associated with multiple content types; allowing for Region as well as Music to be cross-referenced, and describe both articles or pages on your site. Vocabularies can be set to allow terms to define related terms. This functions similar to "see also" in a dictionary.

Each taxonomy term (often called a 'category' or 'tag' in other systems) automatically provides lists of posts and a corresponding RSS feed. These taxonomy/term URLs can be manipulated to generate AND and OR lists of posts classified with terms. There are a significant number of contributed modules which you to alter and extend the behavior of the core module for both display and organization of terms.

Terms: pre-defined
Administrators can define terms for users to classify their content. Terms can be hierarchical; allowing for parent and child relationships between terms. Edit or add a vocabulary, click 'Advanced options' to expand and select a parent term.

Tagging: user-defined
By default there is a Vocabulary called Tags. This allows users to describe content with their own list of comma-separated terms (called tags). This is an example of a non-hierarchical vocabulary. User defined tagging can be added to any vocabulary. Edit or add a Vocabulary, under 'Settings', select Tags.

Extending Taxonomy

The taxonomy module supports the use of both synonyms and related terms, but does not directly use this functionality. However, optional contributed or custom modules may make full use of these advanced features.
For more information, see the online handbook entry for Taxonomy module.

I'm not sure about the current state of this help page in Drupal 7.0, but I would say this is a task, not a bug.

yes

This issue is a duplicate of #461988: Rework Taxonomy help.

Edit: Actually this work was completed later by #640348: Help File Fixup: Taxonomy module.