Early Bird Registration for DrupalCon Portland 2024 is open! Register by 23:59 PST on 31 March 2024, to get $100 off your ticket.
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.
Comment | File | Size | Author |
---|---|---|---|
#12 | menu_help_1.patch | 1.58 KB | keith.smith |
#2 | menu_help_0.patch | 1.16 KB | Rowanw |
menu_help.patch | 1.27 KB | Rowanw | |
Comments
Comment #1
catchThere 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.
Comment #2
Rowanw CreditAttribution: Rowanw commentedRemoved the URLs.
Comment #3
catchLooks good to me.
Comment #4
Gábor HojtsyWell, well, this is the primary menu administration page, so it would IMHO be important not to remove
Comment #5
catchHmm, 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.
Comment #6
Rowanw CreditAttribution: Rowanw commentedI 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.
Comment #7
gaele CreditAttribution: gaele commented+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.
Comment #8
Gábor HojtsyRowanw: 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.
Comment #9
catchGabor, I think Rowanw is referring to: admin/help#menu which has similar text to that being removed by this patch.
Comment #10
Gábor Hojtsycatch: show me people, who read that page :P
Comment #11
catchPeople who don't know what a menu is??
Comment #12
keith.smith CreditAttribution: keith.smith commentedThere 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.
Comment #13
catchYeah 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 :) :)
Comment #14
Rowanw CreditAttribution: Rowanw commentedOne 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.
Comment #15
Gábor HojtsyGreat, this one committed, thanks guys.
Comment #16
(not verified) CreditAttribution: commentedAutomatically closed -- issue fixed for two weeks with no activity.