Re: [Ksummit-discuss] [CORE-TOPIC] Documentation

["Peter Hüwe" <PeterHuewe@gmx.de>]

> > I agree that newbies shouldn't write documentation.
> 
> I semi-disagree.  Assuming you meant newbies here as you defined below.
> 
> Not that an exception should make the rule, but please take a look at
> the Crypto API documentation (with userspace example code!) written by
> Stephan Mueller:

Thanks Jason for this example -- of course that's an (exceptional) exception 
to the rule, I really like it anyway.
 
> Often the best person to write the docs for a newcomer to understand is
> someone who was just recently a newcomer.
:) definitely.

I mentor quite a lot of new colleagues at my company, and you cannot image how 
many 'blind spots' new colleagues can find -- even in 'perfect' 
documentation/tutorials.

Thanks
Peter