[drupal-docs] Regarding the drupal help documentation

[Kieran Lal]

On May 10, 2005, at 3:32 PM, judah wrote:

> we are going to find some usuability issues as we write this  
> documentation up. we are going to find things that need to change  
> or are poorly implemented. what do we do?

We write admin/help for 60 modules and then revise over and over and  
over again until we come up with further refined style guidelines.   
Note, we have to get some thing written down to revise first :-)

> can we make a list of suggested usability changes?

Yes.
1) Provide help text for all 60 modules.
2) Provide links to administration interfaces in the help text.
3) Use the usability technique of information hiding by providing  
links to the configuration and customization handbooks.

See my other posts in this thread for other usability descriptions.

Cheers,
Kieran