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

[Steven Peck]

Ahh, then especially considering the non-native English speakers using the industry standard anacronyms is even more important.  This will let searches in the native language be more effective for these subjects.  Heh heh.
 
When I was in school to learn Electronics our instructor said something interesting.  In the two years we could be expected to learn new words or new, specific definitions of 500-1500 words.  As these words had very specific meanings to our profession that did not necessarily apply to uses outside of it.
 
I am still not sure how to simplify RSS and OMPL any more then it already has been though.  Good luck on the challange. :)
 
-sp

________________________________

From: drupal-docs-bounces at drupal.org on behalf of Anisa
Sent: Sun 5/29/2005 6:09 AM
To: drupal-docs at drupal.org
Subject: Re: [drupal-docs] Admin help longs to be read by skilled Drupal user




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 --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/ms-tnef
Size: 5177 bytes
Desc: not available
Url : http://drupal3.drupal.org/pipermail/documentation/attachments/20050529/f8666efd/attachment.bin