[drupal-docs] Admin help longs to be read by skilled Drupal user

[Kobus Myburgh]

Hi, I have been looking around at the handbook and the websort, and some things are bothering me:

1. In the contributed modules page, take, for example, the buddylist module. It says "you can: allow users to view profiles in  access permissions", which links to Drupal's access permissions. Most people don't have access to those, for obvious reasons, but it still leaves a "bad taste". Either remove the links, or point the link to generic help for the topic instead of trying to go to the page in question.

2. As far as the websort is concerned, there are so many categories on the left-hand side that doesn't fit ANYWHERE in the second column, as far as I can make them fit. Something like "Block tutorial" where does that go? My gut feeling says "developing for Drupal" (eish? - South African word for "really!?"), but depending on the context of what Block tutorial contains, that should be in a section "Help" or something. What about "Configuration and customization" as you do customize blocks as well... Maybe I am looking to literally at this?

Regards,

Kobus


>>> kieran at civicspacelabs.org 5/27/2005 9:18:46 AM >>>
Howdy, 203 of you completed the Drupal documentation survey and told  
us that the number one thing you wanted was module documentation.

The goal of this admin help documentation is:
1) Provide documentation for Drupal modules.
2) Improve the usability of the admin help.
3) Improve the documentation teams ability to work with admin help by  
single sourcing it from the documentation handbook.

Here is the documentation for Drupal core:http://drupal.org/handbook/ 
modules
Here is the documentation for some of Drupal contributions: http:// 
drupal.org/handbook/modules/contributions

The handbook module pages start with executive summaries that are  
also admin help.  Pretty clever, don't you think.  The handbooks are  
currently under development, stay tuned for more improvements.  It  
would be greatly appreciated if knowledgeable Drupal users could read  
some of them and report back on where they are wrong.

If you need a site to confirm this documentation, create an account  
on: http://demo.civicspacelabs.org/home and send me a link to your  
profile.  I'll make sure you get the access you need to confirm the  
documentation is accurate.

Thanks for you help,
Kieran

-- 
[ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]