From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <PeterHuewe@gmx.de>
Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org
	[172.17.192.35])
	by mail.linuxfoundation.org (Postfix) with ESMTPS id 8E397B5A
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Mon, 13 Jul 2015 19:24:05 +0000 (UTC)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.22])
	by smtp1.linuxfoundation.org (Postfix) with ESMTPS id 007977C
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Mon, 13 Jul 2015 19:24:04 +0000 (UTC)
From: Peter =?iso-8859-1?q?H=FCwe?= <PeterHuewe@gmx.de>
To: ksummit-discuss@lists.linuxfoundation.org
Date: Mon, 13 Jul 2015 21:25:56 +0200
References: <201507130038.01474.PeterHuewe@gmx.de>
	<20150713123750.52d8a14d@gandalf.local.home>
	<20150713174244.GE14593@io.lakedaemon.net>
In-Reply-To: <20150713174244.GE14593@io.lakedaemon.net>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <201507132125.56867.PeterHuewe@gmx.de>
Cc: Stephan Mueller <smueller@chronox.de>,
	Dan Carpenter <dan.carpenter@oracle.com>,
	Jason Cooper <jason@lakedaemon.net>
Subject: Re: [Ksummit-discuss] [CORE-TOPIC] Documentation
List-Id: <ksummit-discuss.lists.linuxfoundation.org>
List-Unsubscribe: <https://lists.linuxfoundation.org/mailman/options/ksummit-discuss>,
	<mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=unsubscribe>
List-Archive: <http://lists.linuxfoundation.org/pipermail/ksummit-discuss/>
List-Post: <mailto:ksummit-discuss@lists.linuxfoundation.org>
List-Help: <mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=help>
List-Subscribe: <https://lists.linuxfoundation.org/mailman/listinfo/ksummit-discuss>,
	<mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=subscribe>

> > 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