[documentation] Role Based User Handbooks

[Boris Mann]

On 11-Jan-06, at 11:08 PM, Larry Garfield wrote:

> On Wednesday 11 January 2006 08:22 pm, Boris Mann wrote:
>
>> I *would* love to see this sort of information, it's just NOT
>> official, set in stone documentation per-se...but rather, tips,
>> guidelines, and one particular way of doing things....which is super
>> useful, but is not the same as documentation IMHO.
>
> Isn't that what the "Recipes" book/section was for?  I recall that  
> being
> discussed not long ago, but forget what happened to it.

It does not meet my need of being clear who the author is and having  
it clearly labeled as opinion, and you can't subscribe to it, and  
it's not clear how to submit or what the value is. Never mind that  
it's hard to find, rather than "go here and browse by category/title  
for articles that might prove useful".

Currently, there is more value in posting on your own site and having  
Drupal Planet syndicate...since there is no authorship in handbooks  
and no indicator of "this is the stuff I put together". Note: applies  
*only* to (my term) non-documentation work.

Ideally, a story submission queue with some nice clear categories  
points out a near term way for people to contribute, gain the pride  
of having articles accepted, and feel they are giving back without  
necessarily having to dive into our little documentation morass over  
here (although it may very well prove encouragement to come and  
help). IMHO, this would be a great way for more recipe/consulting/ 
case study/etc. etc. type articles to arise.

--
Boris Mann
Vancouver 778-896-2747 San Francisco 415-367-3595
SKYPE borismann
http://www.bryght.com