[documentation] [Documentation task] menu handbook page needs update

[dww]

Issue status update for 
http://drupal.org/node/57763
Post a follow up: 
http://drupal.org/project/comments/add/57763

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  dww
 Updated by:   dww
 Status:       active

i guess so, sure.  the links in here will be wrong (i'm just cut +
pasting the html from my test site), but you get the idea:


Menus
are a collection of links (menu items) used to navigate a website. The
menu module provides an interface to control and customize the powerful
menu system that comes with Drupal. Menus are primarily displayed as a
hierarchical list of links using Drupal's highly flexible blocks [1]
feature. Each menu automatically creates a block of the same name. By
default, new menu items are placed inside a built-in menu labelled
/Navigation/, but administrators can also create custom menus.


Drupal themes generally provide out-of-the-box support for two menus
commonly labelled /primary links/ and /secondary links/.
These are sets of links which are usually displayed in the header or
footer of each page (depending on the currently active theme). Any menu
can be designated as the primary or secondary links menu via the menu
settings page [2].


Menu administration tabs:



* On the administer menu page, administrators can "edit" to
change the title, description, parent or weight of a menu item. Under
the "operations" column, click on "enable/disable" to toggle a menu
item on or off. Only menu items which are enabled are displayed in the
corresponding menu block. Note that the default menu items generated by
the menu module cannot be deleted, only disabled.
* Use the
"add menu" tab to submit a title for a new custom menu. Once submitted,
the menu will appear in a list toward the bottom of the administer menu
page underneath the main navigation menu. Under the menu name there
will be links to edit or delete the menu, and a link to add new items
to the menu.
* Use the "add menu item" tab to create new links
in either the navigation or a custom menu (such as a primary/secondary
links menu). Select the parent item to place the new link within an
existing menu structure. For top level menu items, choose the name of
the menu in which the link is to be added.

You can



* administer menus at administer >> menus [3].
* add a menu at administer >> menus >> add menu [4].
* add a menu item at administer >> menus >> add menu item [5].
* modify menu settings (in particular, to specify a menu to use for
primary or secondary links) at administer >> settings >> menus [6].
* manage menu blocks at administer >> blocks [7].

For more information please read the configuration and customization
handbook Menu page [8]
[1] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/block
[2] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/settings/menu
[3] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/menu
[4] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/menu/menu/add
[5] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/menu/item/add
[6] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/settings/menu
[7] http://drupal.org//drupal-4-7/%3Fq%3Dadmin/block
[8] http://drupal.org/handbook/modules/menu/




dww



Previous comments:
------------------------------------------------------------------------

Fri, 07 Apr 2006 17:30:24 +0000 : dww

webchick asked me to create a new documentation issue now that #53870
[9] has been committed.  the patch from comment #22 [10] in the thread
(applied as revision includes a big re-write of the menu module's help
text in various places, care of much back and forth between zen and
myself.  webchick tells me there's a (to my perspective somewhat
strange) procedure where the handbook text on drupal.org is used to
automatically generate the help text in the core modules.  so, the menu
handbook page [11] is hereby out of date/sync with the new, better text
in the code.  someone w/ doc privs needs to keep them in sync for
reasons more clear to webchick than myself. ;)


thanks!
-derek


p.s. sorry if "documentation in cvs" is the wrong component for this,
but that seemed like the closest match...
[9] http://drupal.org//node/53870
[10] http://drupal.org//node/53870%23comment-87658
[11] http://drupal.org//handbook/modules/menu




------------------------------------------------------------------------

Fri, 07 Apr 2006 17:34:08 +0000 : dww

sorry, that "(applied as revision" was supposed to be "(applied as
revision 1.73 in modules/menu.module)".  i'm trying to do too many
things at once right now...




------------------------------------------------------------------------

Fri, 07 Apr 2006 17:36:18 +0000 : sepeck

People said updating the help text found in the modules was challanging
so this alternative method was established that allowed for many more
people to provide edits and updates and these edits/updates to be
applied to the modules themselves.  This allows for the handbook to
remain in sync with the modules and the modules to link accuratly with
the handbook.


Is it possible for you to provide the text of your changes here?