From mboxrd@z Thu Jan 1 00:00:00 1970 From: Konrad Rzeszutek Wilk Subject: Re: Xen document day (Oct 12 or 26) Date: Thu, 22 Sep 2011 13:40:02 -0400 Message-ID: <20110922174002.GA1205@phenom.oracle.com> References: <20110922130618.GA13238@phenom.oracle.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Content-Disposition: inline In-Reply-To: List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xensource.com Errors-To: xen-devel-bounces@lists.xensource.com To: George Dunlap Cc: xen-devel@lists.xensource.com, xen-users@lists.xensource.com List-Id: xen-devel@lists.xenproject.org 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 > 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@lists.xensource.com > > http://lists.xensource.com/xen-devel > > > > _______________________________________________ > Xen-devel mailing list > Xen-devel@lists.xensource.com > http://lists.xensource.com/xen-devel