Menu help text is incorrect (admin/build/menu)
Rowanw - November 25, 2007 - 03:57
| Project: | Drupal |
| Version: | 6.x-dev |
| Component: | menu system |
| Category: | bug report |
| Priority: | normal |
| Assigned: | Unassigned |
| Status: | closed |
Description
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.
| Attachment | Size |
|---|---|
| menu_help.patch | 1.27 KB |
#1
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.
#2
Removed the URLs.
#3
Looks good to me.
#4
Well, well, this is the primary menu administration page, so it would IMHO be important not to remove
#5
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.
#6
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.
#7
+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.
#8
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.
#9
Gabor, I think Rowanw is referring to: admin/help#menu which has similar text to that being removed by this patch.
#10
catch: show me people, who read that page :P
#11
People who don't know what a menu is??
#12
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.
#13
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 :) :)
#14
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.
#15
Great, this one committed, thanks guys.
#16
Automatically closed -- issue fixed for two weeks with no activity.