From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NaxqJ-00013N-DZ for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:53:27 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NaxqF-0000ym-At for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:53:26 -0500 Received: from [199.232.76.173] (port=40020 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NaxqE-0000yZ-LP for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:53:22 -0500 Received: from mail-iw0-f172.google.com ([209.85.223.172]:51434) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NaxqE-0002Ev-CL for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:53:22 -0500 Received: by iwn2 with SMTP id 2so1752375iwn.19 for ; Fri, 29 Jan 2010 12:53:21 -0800 (PST) Message-ID: <4B634ABE.2020100@codemonkey.ws> Date: Fri, 29 Jan 2010 14:53:18 -0600 From: Anthony Liguori MIME-Version: 1.0 Subject: Re: [Qemu-devel] [RFC] wiki.qemu.org References: <4B633A80.100@codemonkey.ws> <959734E2-77CD-472D-8557-EB8AE88E8766@web.de> In-Reply-To: <959734E2-77CD-472D-8557-EB8AE88E8766@web.de> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: =?ISO-8859-1?Q?Andreas_F=E4rber?= Cc: qemu-devel On 01/29/2010 02:29 PM, Andreas Färber wrote: > Hi, > > Am 29.01.2010 um 20:44 schrieb Anthony Liguori: > >> I need to figure out what to do with the current texi documentation. >> I think it makes sense to move qemu-doc.texi to a wiki page and >> remove it from the source repository. The other option would be to >> link to it as an external page and keep it within revision control. > > The latter allows to have a stable version on the website and a > development version inside the repository. > Otherwise we would either document unavailable options or, if we > don't, probably forget adding Wiki documentation after a release. > Also, would you want to ship a snapshot of the Wiki page with the > source tarballs? If we have documentation on the website, I think it may be appropriate to just include a man page in the source tarball and leave all of the other documentation on the website. I think our user manual is currently a bit difficult to read through and is certainly out of date in a lot of places. My expectation is that putting it on the wiki would result in it becoming quite a bit more readable and quite a bit more up-to-date. > The Wiki looks more pretty though. :) Yeah, I like it too. The theme is the same as what's used on wiki.mozilla.org. Regards, Anthony Liguori > Regards, > Andreas