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

[Anisa]

Steven Peck wrote:

> 
>Our users are capable of learning.  If we see a term, then we need to have a glossary or link to wikipedia definitions.  We can then continue to refer to something by it's proper name/term.  Using proper names/terms allows site admins to look up these terms and search the Internet for articles on leveraging these technologies.  If we 'make up' simple names, we continue down the path to obscurity that Drupal already has a reputation for.
> 
>  
>
chao, chao, not suggesting making up anything at all!  I suppose it 
sounded like that.  I meant that 1) any of those alphabet soup things 
should be linked to a reference (as you suggest above) for at least the 
first time on the page and 2) the general language can be simplied 
without worrying about 'talking down' to the users. When you consider 
the number of non-native speakers of English reading through this, you 
have to admit, simple straightforward language is the only way to go.  
For example, and this is not to pick on Kieran et al, for the upload 
module, it actually says the upload module is important for 'collective 
work products' which is, well, odd.

:)

Anisa.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050529/b182dcbd/attachment.htm