Watched the video a couple times. Still need a good step thru documentation or video.
The site I have installed is production site. I cannot experiment.
Your terminology I am sure is fine. I just have to get better understanding of it.
Maybe you could think about a video that starts after installed, explaining the reasoning.
Menu and Taxonomy? I'm basically just interested to have editor moderation on Content Types before publish.

The Sections thing... I'm really screwed up on that.

Don't take this negative I've NOT worked enough with it...

I believe it will be a most used module package in Drupal.

Thank you

CommentFileSizeAuthor
#5 workbench-permission_descriptions-1242178-5.patch1.4 KBdrupalmonkey
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

domineaux’s picture

domineaux CreditAttribution: domineaux commented

I just found this docs, looks like it may be a big help

http://drupal.org/node/1171018

Again, thanks for what appears to be an excellent module

domineaux’s picture

domineaux CreditAttribution: domineaux commented

It would help alot to understand just what each line item means in permissions

I just did a copy paste from admin/people/permissions - and the array is down in lieu of across.

Regardless, you can view the permissions on your site and see what I'm talking about.

Some of the terms are easy, some not so easy to understand just what they do and how various users affected.
--------------------------------------------------------------
Workbench

Line 1

Administer Workbench settings

anonymous user: Administer Workbench settings

authenticated user: Administer Workbench settings

contributor: Administer Workbench settings

Author: Administer Workbench settings

Editor: Administer Workbench settings

administrator: Administer Workbench settings

Line 2

Access My Workbench

anonymous user: Access My Workbench

authenticated user: Access My Workbench

contributor: Access My Workbench

Author: Access My Workbench

Editor: Access My Workbench

administrator: Access My Workbench

Workbench Access

Administer Workbench Access settings

anonymous user: Administer Workbench Access settings

authenticated user: Administer Workbench Access settings

contributor: Administer Workbench Access settings

Author: Administer Workbench Access settings

Editor: Administer Workbench Access settings

administrator: Administer Workbench Access settings

Etc, Etc.

robeano’s picture

robeano CreditAttribution: robeano commented

@davereid told me just now that we can add descriptions to permissions. I would like to add the descriptions for sure and perhaps followup with a handbook page on d.o

agentrickard’s picture

agentrickard
he/him
Primary language English
Location Georgia (US)
CreditAttribution: agentrickard commented
Title: Config, permissions and sections walk thru for some typical installs would help alot. » Document typical installs
Component: Miscellaneous » Documentation

Note that anyone can add documentation to the handbook.

https://drupal.org/documentation/modules/workbench

drupalmonkey’s picture

drupalmonkey CreditAttribution: drupalmonkey commented
Status: Active » Needs review
FileSize
workbench-permission_descriptions-1242178-5.patch1.4 KB

Added descriptions for the permissions in Workbench, I'll make tickets in the other WB modules to update their permissions.

barraponto’s picture

barraponto CreditAttribution: barraponto commented
Title: Document typical installs » Add descriptions to workbench permissions
Version: 7.x-1.0-beta6 » 7.x-1.x-dev
agentrickard’s picture

agentrickard
he/him
Primary language English
Location Georgia (US)
CreditAttribution: agentrickard commented

I don't think you can put links in the descriptions like that without checking for access to the links. Generally, links are not added to descriptions.

barraponto’s picture

barraponto CreditAttribution: barraponto commented

Switching to l() would give us access checks.

The descriptions must make sense even if they're not linking anywhere.

BTW, core filter and user modules have links in their permissions titles and descriptions. They follow the same pattern as those in the patch, using url().

agentrickard’s picture

agentrickard
he/him
Primary language English
Location Georgia (US)
CreditAttribution: agentrickard commented

The UX team guideines I've seen would say that these descriptions don't add enough extra context to be worth adding.

barraponto’s picture

barraponto CreditAttribution: barraponto commented

Should we try better descriptions that added more context?

agentrickard’s picture

agentrickard
he/him
Primary language English
Location Georgia (US)
CreditAttribution: agentrickard commented

I would.

damontgomery’s picture

damontgomery CreditAttribution: damontgomery commented

The only two permissions that are only for Workbench (not other sub modules) are "Administer Workbench Settings" and "Access My Workbench".

The only confusion I can see is that once Workbench Access is also used, there is confusion with the repetition of "access".

I recommend simply following the naming convention in the rest of the core permissions and change "Access My Workbench" to "Access My Workbench Pages". This doesn't seem like much of an improvement, so we could stray a little bit and use "View My Workbench Pages".

domineaux, can you provide more information on what part was confusing? Since this issue is so old and it's unclear what the confusion was, it might be a good idea to closed (won't fix) this issue.