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 780CF7E
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Tue,  4 Aug 2015 08:33:45 +0000 (UTC)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.21])
	by smtp1.linuxfoundation.org (Postfix) with ESMTPS id A04577D
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Tue,  4 Aug 2015 08:33:44 +0000 (UTC)
In-Reply-To: <9B190076-263A-4C51-AFA4-A1D7FD403BC3@holtmann.org>
References: <20150801164142.653012af@lwn.net>
	<1438672367.9418.3.camel@ellerman.id.au>
	<9B190076-263A-4C51-AFA4-A1D7FD403BC3@holtmann.org>
MIME-Version: 1.0
Content-Type: text/plain;
 charset=UTF-8
Content-Transfer-Encoding: quoted-printable
From: Peter Huewe <peterhuewe@gmx.de>
Date: Tue, 04 Aug 2015 10:33:02 +0200
To: Marcel Holtmann <marcel@holtmann.org>,
	Michael Ellerman <mpe@ellerman.id.au>
Message-ID: <BC939929-C5D1-4239-A9B8-E9D49CD4E04E@gmx.de>
Cc: ksummit-discuss@lists.linuxfoundation.org
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>

Hi

Am 4=2E August 2015 09:42:55 MESZ, schrieb Marcel Holtmann <marcel@holtman=
n=2Eorg>:
>Hi Michael,
>
>>> Markdown in one of its many forms might be a good alternative here=2E=
=20
>I'm
>>> also somewhat attracted by Sphinx, which is designed for documenting
>code
>>> already and could probably be made to work well with our existing
>kerneldoc
>>> comments without a whole lot of trouble=2E  The Sphinx idea, though,
>is
>>> hobbled by the inconvenient fact that I've not had the time to
>develop it
>>> far enough to even have a vague idea of whether it would make
>real-world
>>> sense=2E
>>=20
>> I'd vote for Markdown=2E It's very unobtrusive, reads nicely as plain
>text, and
>> all the young kids know it from writing Github README=2Emd files=2E
>
>actually AsciiDoc might be something to look into as well=2E
>
I'm also in for AsciiDoc, as it also allows easy generation of Pdfs and ht=
ml files, with chapters and all that fancy stuff=2E

(Probably the reason why docbook was chosen back then, compared to the pla=
intext files)

Peter
--=20
Sent from my mobile