From mboxrd@z Thu Jan  1 00:00:00 1970
From: Sander Eikelenboom <linux@eikelenboom.it>
Subject: Re: Xen document day (Oct 12 or 26)
Date: Mon, 26 Sep 2011 22:24:39 +0200
Message-ID: <499921842.20110926222439@eikelenboom.it>
References: <20110922130618.GA13238@phenom.oracle.com>
	<CAFLBxZaAaXTUtW5+VkxPnr_MR0fbW+d1Mzu4y0x=gEOaX9e0OQ@mail.gmail.com>
	<20110922174002.GA1205@phenom.oracle.com>
	<1316852066.27431.15.camel@dagon.hellion.org.uk>
	<20110926181536.GA8213@phenom.oracle.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-15
Content-Transfer-Encoding: quoted-printable
Return-path: <xen-devel-bounces@lists.xensource.com>
In-Reply-To: <20110926181536.GA8213@phenom.oracle.com>
List-Unsubscribe: <http://lists.xensource.com/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xensource.com?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xensource.com>
List-Help: <mailto:xen-devel-request@lists.xensource.com?subject=help>
List-Subscribe: <http://lists.xensource.com/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xensource.com?subject=subscribe>
Sender: xen-devel-bounces@lists.xensource.com
Errors-To: xen-devel-bounces@lists.xensource.com
To: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Cc: George Dunlap <George.Dunlap@eu.citrix.com>, "xen-devel@lists.xensource.com" <xen-devel@lists.xensource.com>, Ian Campbell <Ian.Campbell@citrix.com>, "xen-users@lists.xensource.com" <xen-users@lists.xensource.com>
List-Id: xen-devel@lists.xenproject.org

Hello Konrad,

Monday, September 26, 2011, 8:15:36 PM, you wrote:

> On Sat, Sep 24, 2011 at 09:14:26AM +0100, Ian Campbell wrote:
>> On Thu, 2011-09-22 at 18:40 +0100, Konrad Rzeszutek Wilk wrote:
>> > On Thu, Sep 22, 2011 at 05:32:46PM +0100, George Dunlap wrote:
>> > > Another thing that needs to be done is to write man pages for xl, and
>> > > update the man pages for xm to indicate that it is deprecated.
>> >=20
>> > So:
>> >=20
>> >  1). PDF/section
>> >  2). Wiki
>> >  3). man page for xl/xm
>> >  4). HOWTO, docs in xen.hg/docs
>> >  5). Convert said HOWTO, docs in Markdown.
>>=20
>> Another thing which came up which I'd like to do was setting up doxygen
>> (or something similar, recommendations greatfully received) for
>> xen/include/public to allow us to document the hypercall interface
>> inline, with the intention of replacing interface.tex with something we
>> might actually maintain.

> OK, so:
>  1). PDF/section -> convert to something we can easily understand
>      and it creates nice PDFs.
>  2). Wiki

Some pages i missed in your previous lists:
     - http://wiki.xensource.com/xenwiki/XenHypervisorBootOptions
     - List of Xen specific/related Linux kernel boot options
     - A very good (set of) structured start page(s) so you get a overview =
of what documentation is available

>  3). man page for xl/xm
>  4). HOWTO, docs in xen.hg/docs
>  5). Convert said HOWTO, docs in Markdown.

>>=20
>> >=20
>> > Who wants to do what? I created a sign up sheet:
>> >=20
>> > https://docs.google.com/spreadsheet/ccc?key=3D0Aj5ukWh4htwMdEFLVWpjRmx=
3VXdETDExNlByamd4Rmc&hl=3Den_US
>> >=20
>> > in case folks want to get an idea of who is doing what and not
>> > step on each toes.
>>=20
>> We should have a specific IRC channel on the day too (e.g.
>> #xen-documentathon on freenode).

> <nods> Will do that. Was thinking to send a more "official" email
> along with a blog post on Xen.org

> But before I do that - date? Does that date work for folks? Oct 12th?
> Or is Oct 26th better?





--=20
Best regards,
 Sander                            mailto:linux@eikelenboom.it