From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:50828) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQCBg-0005b5-9l for qemu-devel@nongnu.org; Tue, 15 Nov 2011 01:08:05 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQCBe-0004wc-QQ for qemu-devel@nongnu.org; Tue, 15 Nov 2011 01:08:04 -0500 Received: from v220110690675601.yourvserver.net ([78.47.199.172]:38620) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQCBe-0004wY-Ke for qemu-devel@nongnu.org; Tue, 15 Nov 2011 01:08:02 -0500 Message-ID: <4EC20190.2020001@weilnetz.de> Date: Tue, 15 Nov 2011 07:07:12 +0100 From: Stefan Weil MIME-Version: 1.0 References: <1321310505-27845-1-git-send-email-aliguori@us.ibm.com> In-Reply-To: <1321310505-27845-1-git-send-email-aliguori@us.ibm.com> Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Anthony Liguori Cc: qemu-devel@nongnu.org Am 14.11.2011 23:41, schrieb Anthony Liguori: > Right now our specs are written in psuedo-wiki syntax. This series converts > them to markdown. markdown is a simple markup format that's gaining in > popularity. > > The big advantage of using markdown is that there are tools that can convert it > to relatively simple HTML. That means we can build a make infrastructure that > generates a nice set of static web pages. > > The syntax is also more human friendly than mediawiki syntax. > > To see what the stylized version of this looks like, check out: > > https://github.com/aliguori/qemu/tree/markdown/docs/specs Maybe the file names could also be cleaned: either remove _spec as it is not needed (or do you add _src to source file names), or add it to all file names. Regards, Stefan Weil