Original issue: http://drupal.org/node/537828

I stripped out a lot of text that was either duplicating what is on the main menu admin page, or seemed more appropriate to be left in the handbook.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

jhodgdon’s picture

Patch review:

a) Very minor text comment:
Menus are a hierarchical collection of...

Seems it should be "Menus are hierarchical collections" or "A menu is a hierarchical collection"?

Hmmm... I'm also a bit uncomfortable with the style of the rest of the sentence:
of links used to navigate a website, or sometimes to external websites.

How about:
"A menu is a hierarchical collection of links, which can be within or external to the site, generally used for navigation."

b) Custom menus can be either special site menus, or menus of external links, or any combination
Too many "or"s here?

c) Patch indentation is not consistent. Needs to use just spaces, not tabs, and all be indented the same (2 spaces per indentation level).

Other than that, I like it...

Oh, one other thing:

d) There will soon be only 5 default menus (I hope). See #637702: Get rid of Administration Shortcuts menu, which will get rid of the Admin Shortcuts menu. Just FYI...

jhodgdon’s picture

Regarding (d), how about rather than listing what the default menus are, just saying that there are some defaults and you can see them on the Menus admin screen? Because these menus are set up when you enable various core modules, and it's possible not everyone will have the same set of "default" menus (for instance that admin shortcuts menu was installed by Toolbar).

jhodgdon’s picture

Status: Needs review » Needs work

I guess I forgot to change the status before, sorry.

arianek’s picture

Status: Needs work » Needs review
FileSize
4.65 KB

stab #2

arianek’s picture

FileSize
4.62 KB

ok, now i am just going to blame my text editor, there's no way i messed this many up! fixed indents

jhodgdon’s picture

Status: Needs review » Needs work

A few new comments:
a) " provides an interface to control and customize menus" ... What type of "control"? How about:
"provides an interface for managing menus"
b) "Default menus can be viewed and managed on the"... Can't all menus be viewed and managed there?
c) It seems like there are more uses than just adding new menus... Maybe there should be a section on some of the other tasks, like maybe "Menu management" that mentions you can add new items to existing menus, edit the link text, etc.

batigolix’s picture

Status: Needs work » Needs review
FileSize
57.63 KB
4.6 KB

#6 a) done
b) done
c) done

arianek’s picture

Status: Needs review » Reviewed & tested by the community
FileSize
90.15 KB
4.77 KB

cleaned up some grammatical errors, punctuation standards, coding standards, and redundant links. i think this is ready to ship.

webchick’s picture

Status: Reviewed & tested by the community » Fixed

Looks great! Committed to HEAD.

Status: Fixed » Closed (fixed)
Issue tags: -Documentation, -Help text, -drupal7, -d7help

Automatically closed -- issue fixed for 2 weeks with no activity.