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.

CommentFileSizeAuthor
remove.glossary.patch2.46 KBGábor Hojtsy
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

catch’s picture

Agree 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).

catch’s picture

Status: Needs review » Reviewed & tested by the community
Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Needs review

Let's gather some more opinions first before rushing this in.

webchick’s picture

Component: help.module » documentation

Hm. 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?

catch’s picture

Some 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.

Gábor Hojtsy’s picture

Yes, 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).

keith.smith’s picture

Assigned: Unassigned » keith.smith

I'll take a crack at this later on today; assigning to myself until I get a patch in for it.

JirkaRybka’s picture

I 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.

keith.smith’s picture

Copying over the relevant part of O Govinda's commentary at http://drupal.org/node/101090:

Glossary of Drupal terminology

-----------
Block

NOW:
A small box containing information or content placed in the left-hand or right-hand sidebar of a web page.

REVISED:

A box of content that may be placed into a certain region of a web page--for example, into a sidebar.

-----------
Moderation

NOW:
The activity of making sure a post to a Drupal site fits in with what is expected for that Drupal site.

Approved

A moderated post which has been accepted by the moderators for
publication (see published).

Waiting

A moderated post which is still being voted on to be accepted for
publication (see published).

REVISED:
Review of a post, before it is published, to make sure it fits your Drupal site.

Approved

Accepted for publication. (See published.)

Waiting

Still awaiting approval.

--------------
Public

NOW:
See published.

REVISED:
Published. [If "public" = "published," drop "See."]

--------------

Published

NOW:
A node that is viewable by everyone (see unpublished).

REVISED:
"Live." Viewable not only by administrators or moderators but by all intended viewers.

MY COMMENT: A node may be published but, because of access restrictions, not be viewable to everyone.

-------------

Role

NOW:
A classification users are placed into for the purpose of setting users' permissions.

REVISED:
A status assigned to a user, granting certain permissions. (Examples of roles are "administrator" and "unauthenticated user.")

------------

Taxonomy

NOW:
A division of a collection of things into ordered, classified groups (see taxonomy help).

REVISED:
A system for ordering things into groups. (See taxonomy help.)

------------

Unpublished

NOW:
A node that is only viewable by administrators and moderators.

REVISED:
Viewable only by administrators and moderators.

-----------

User

NOW:
A person who has an account at your Drupal site, and is logged in with that account.

REVISED:
A person who has an account on your site or who anonymously logs in.

MY COMMENT:
I'm assuming that an unauthenticated user is still a user.

--------------

Visitor

NOW:
A person who does not have an account at your Drupal site or a person who has an account at your Drupal site but is not logged in with that account. Also termed "anonymous user".

REVISED:
A person who comes to your site without having an account or who has an account but is not logged in. Also termed "anonymous user".

MY COMMENT:
Is this definition too narrow? I wonder whether people loosely use "visitor" to include even authenticated users. (In other words, do they make no distinction between "visitor" and "user"?)

Gábor Hojtsy’s picture

Moderatio stuff was removed from this help text before, when the moderation feature was removed from core.

keith.smith’s picture

Assigned: keith.smith » Unassigned

I 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....

Gábor Hojtsy’s picture

Seems like so far all attempts to fix this text failed.

catch’s picture

Status: Needs review » Reviewed & tested by the community

Still applies. Everyone who's stepped up to fix it wants to nuke it, back to RTBC.

Dries’s picture

I'll let Gabor handle this. I don't mind removing it.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Fixed

OK, committed.

Anonymous’s picture

Status: Fixed » Closed (fixed)

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