While doing a test translation run on the generic Drupal strings (which are not extracted well still), I found that this glossary of Drupal terms is still on the help page, but is miserably outdated. It might be possible to update it (in which case it should be broken up to t() wrapped strings per list items), but I think it is not worth it. The descriptions here are too generic and they would need to be different from site to site. Problems I noticed:
- comments could also express opinion, criticize, etc. another comment, not just the original post
- node is a word we are not using on the interface and should not explain here
- published content might not be visible to all visitors, depending on role/content type settings and per node permissions
- roles are not THE solution for permissions, but are the simple built-in defaults
- again, taxonomy is a word we are not using on the interface and should not explain here
- unpublished nodes are also visible to their authors by default
- a visitor might not only be a person, web crawlers are also counted as visitors
So this text is very much outdated, misleading on some occasions, and definitely very restrictive on most occasions. I am not sure we can provide a better, accurate version as for example, the definition of what a published node is differs from site to site for example (could also depend on workflow). So I suggest we remove this block of definitions and clean up the t() usage a bit.
Opinions please.
Comment | File | Size | Author |
---|---|---|---|
remove.glossary.patch | 2.46 KB | Gábor Hojtsy | |
Comments
Comment #1
catchAgree entirely. The page is much tidier without it, and that's the sort of information that should live in the handbook (linked from admin/help anyway).
Comment #2
catchComment #3
Gábor HojtsyLet's gather some more opinions first before rushing this in.
Comment #4
webchickHm. I would prefer fixing this to removing it altogether. And even though 'node' is not used in any user-facing text, it is used in the URLs of all posts, in the modules page, etc. and there are many contrib modules called node_something. It's reasonable someone would want to know what in the world it meant, and it's a very generic term, so it's not like people could easily Google for it to figure it out. Same with 'taxonomy'. I actually happen to believe that removing those terms from user-facing text was one of the most user-confusing things we ever did, but that's digressing. ;)
Also, moving to the documentation queue. Although help.module is technically correct, the actual bug is just about the text. It'll get more reviews/help from the docs team if it's in this queue. Maybe some of these definitions could be culled from the new getting started guide?
Comment #5
catchSome stuff like "comments and users aren't nodes" become inaccurate with node_comment or usernode modules (although if you use those you may not be worried about the glossary I guess). I'd prefer a link to the relevant sections of the getting started guide to having this hardcoded per release.
Comment #6
Gábor HojtsyYes, the actual problem with most statements in this help text is that they describe the "out of the box" behaviour, and then there is no way someone can override some help here or add new ones. It makes this a pretty "helpless" piece of help text as far as I see. I can still see it being fixed to some degree though (possibly removing only parts of it, or rewording to be more "feature neutral", which then makes it lose most of the possible helpfulness unfortunately).
Comment #7
keith.smith CreditAttribution: keith.smith commentedI'll take a crack at this later on today; assigning to myself until I get a patch in for it.
Comment #8
JirkaRybka CreditAttribution: JirkaRybka commentedI would rather vote for removal. When I started with Drupal, I came across this Glossary, and it felt (besides of the inaccurate contents, which I didn't recognize back then) too short and incomplete to be really helpful. I never came back to that page, it's only just another page which overloads the localization with useless huge texts IMO. I would prefer a really helping link to a full page at drupal.org.
Comment #9
keith.smith CreditAttribution: keith.smith commentedCopying over the relevant part of O Govinda's commentary at http://drupal.org/node/101090:
Comment #10
Gábor HojtsyModeratio stuff was removed from this help text before, when the moderation feature was removed from core.
Comment #11
keith.smith CreditAttribution: keith.smith commentedI didn't get anything accomplished on a patch for fixing this; every time I start, I find myself waffling between wanting to fix it and wanting to nuke it as originally suggested.
Un-assigning myself in case someone else wants to work on it....
Comment #12
Gábor HojtsySeems like so far all attempts to fix this text failed.
Comment #13
catchStill applies. Everyone who's stepped up to fix it wants to nuke it, back to RTBC.
Comment #14
Dries CreditAttribution: Dries commentedI'll let Gabor handle this. I don't mind removing it.
Comment #15
Gábor HojtsyOK, committed.
Comment #16
(not verified) CreditAttribution: commentedAutomatically closed -- issue fixed for two weeks with no activity.