At admin/build/menu the help text implies that there may be lists of menu items below, however the page does not display any menu items.

Current text

Menus are a collection of links (menu items) used to navigate a website. The list(s) below display the currently available menus along with their menu items. Select an operation from the list to manage each menu or menu item. [more help...]

Suggested

Below is a list of all the menus on your site. [more help...]

Honestly, it doesn't need to say very much.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

catch’s picture

Status: Needs review » Needs work

There doesn't seem to be any need for the url calls (they were there before, but might as well remove them).

Also not really within the scope of this issue but admin/help/menu doesn't mention drag and drop yet.

Rowanw’s picture

Status: Needs work » Needs review
FileSize
1.16 KB

Removed the URLs.

catch’s picture

Component: language system » menu system
Status: Needs review » Reviewed & tested by the community

Looks good to me.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Needs work

Well, well, this is the primary menu administration page, so it would IMHO be important not to remove Menus are a collection of links (menu items) used to navigate a website.

catch’s picture

Hmm, well we don't explain what themes are on the theme administration pages, and I'd say menus are far more a generic term than theme (skin etc.), to me it seemed like overkill.

Rowanw’s picture

I think there's plenty of hints in the individual menu descriptions as well, I don't think there's a need to explain what a menu is on that page, the help text explains that pretty well.

gaele’s picture

Status: Needs work » Reviewed & tested by the community

+1 from me too, so I'll try again ;-)

I see another problem: the name "Navigation" is confusing. It suggests that "Primary links" and "Secondary links" are not for navigation. But that's outside the scope.

Gábor Hojtsy’s picture

Rowanw: You say: I don't think there's a need to explain what a menu is on that page, the help text explains that pretty well. The patch actually removes any description on what a menu is, so how does it explain it pretty well? This seems like a contradiction to me. Although to us, a menu seems like one of the most well known concepts, a newbie can just as well get some help with that short description IMHO, and it does not distract.

catch’s picture

Gabor, I think Rowanw is referring to: admin/help#menu which has similar text to that being removed by this patch.

Gábor Hojtsy’s picture

catch: show me people, who read that page :P

catch’s picture

People who don't know what a menu is??

keith.smith’s picture

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

There must be something here I'm not understanding. The original text is misleading in that it refers to things being on the page that aren't, but the new text is a bit terse. Would something like the attached patch clear up the technical inaccuracy of the current text, while leaving the hint about menus?

And, catch and Gabor are both right, in one of the great paradoxes of the computer age.

Nobody reads help text, except when they really, really, need help.

catch’s picture

Status: Needs review » Reviewed & tested by the community

Yeah this is good. At the end of the day it doesn't matter if that one explanatory sentence is in if the other one that makes no sense gets fixed :) :)

Rowanw’s picture

One of my plans for D7 is to improve the visibility of the 'help' links, so they're not in square brackets on the right side of the page. :) But that's another issue.

The latest wording is OK.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Fixed

Great, this one committed, thanks guys.

Anonymous’s picture

Status: Fixed » Closed (fixed)

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