WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/
   
 
 
Xen 
 
Home Products Support Community News
 
   
 

xen-devel

Re: [Xen-devel] Xen document day (Oct 12 or 26)

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.

So:

 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.

Who wants to do what? I created a sign up sheet:

https://docs.google.com/spreadsheet/ccc?key=0Aj5ukWh4htwMdEFLVWpjRmx3VXdETDExNlByamd4Rmc&hl=en_US

in case folks want to get an idea of who is doing what and not
step on each toes.

> 
> We also discussed the idea of moving some of the documentation and the
> HOWTOs into the xen.hg/docs folder, preferrably in a nice language
> like Markdown, so that we can enforce changes in documentation with
> changes code.  I propose using Markdown, if no one has a better idea.

Which pretty much looks like writting normal text files per
http://en.wikipedia.org/wiki/Markdown description.
> :-)
> 
>  -George
> 
> On Thu, Sep 22, 2011 at 2:06 PM, Konrad Rzeszutek Wilk
> <konrad.wilk@xxxxxxxxxx> wrote:
> > Part of what we brainstormed at Xen Hackathon was what we could do make Xen 
> > easier.
> >
> > And the one thing that seemed to surface up was making the docs better - 
> > either
> > be the Wiki or the three .pdfs that get created/shipped with Xen.
> >
> > One thought was to come up with a Documention Day - where volunteers would 
> > try to
> > fix up some portion of the documentation that they feel they have
> > a good grasp of knowledge off and are willing to change (and also look
> > to be incorrect)
> >
> > What do you guys think of Oct 12th or Oct 26 as a day for this?
> >
> > And then the next question - what page/pdf section interests you?
> >
> > http://bits.xensource.com/Xen/docs/user.pdf
> > http://www.rites.uic.edu/~solworth/xenInterfaceManual.pdf [the one on 
> > Xen.org is an older version]
> >
> > Or Wiki pages:
> > http://wiki.xensource.com/xenwiki/
> >
> > http://wiki.xensource.com/xenwiki/XenDom0Kernels
> > http://wiki.xensource.com/xenwiki/XenSerialConsole
> > http://wiki.xensource.com/xenwiki/XenParavirtOps
> > http://wiki.xensource.com/xenwiki/XenCommonProblems
> >
> > http://wiki.xensource.com/xenwiki/Consulting
> > http://wiki.xensource.com/xenwiki/Consultants
> > http://wiki.xensource.com/xenwiki/VpsHostingWithXen
> >
> > http://wiki.xen.org/xenwiki/XenPCIpassthrough
> > http://wiki.xen.org/xenwiki/VTdHowTo
> >
> > _______________________________________________
> > Xen-devel mailing list
> > Xen-devel@xxxxxxxxxxxxxxxxxxx
> > http://lists.xensource.com/xen-devel
> >
> 
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@xxxxxxxxxxxxxxxxxxx
> http://lists.xensource.com/xen-devel

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel