From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Castro Subject: Re: Xen document day (Oct 12 or 26) Date: Wed, 28 Sep 2011 07:18:36 +0900 Message-ID: References: <20110922130618.GA13238@phenom.oracle.com> <20110922174002.GA1205@phenom.oracle.com> <20098.1097.824552.541924@mariner.uk.xensource.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Return-path: In-Reply-To: <20098.1097.824552.541924@mariner.uk.xensource.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xensource.com Errors-To: xen-devel-bounces@lists.xensource.com To: Ian Jackson , xen-devel@lists.xensource.com Cc: Konrad Rzeszutek Wilk List-Id: xen-devel@lists.xenproject.org On Wed, Sep 28, 2011 at 2:13 AM, Ian Jackson wr= ote: > Konrad Rzeszutek Wilk writes ("Re: [Xen-devel] Xen document day (Oct 12 o= r 26)"): >> [ docs todo list ] > ... >> Who wants to do what? I created a sign up sheet: >> >> https://docs.google.com/spreadsheet/ccc?key=3D0Aj5ukWh4htwMdEFLVWpjRmx3V= XdETDExNlByamd4Rmc&hl=3Den_US >> >> in case folks want to get an idea of who is doing what and not >> step on each toes. > > Daniel, I see you have put yourself down for some things to do with > "PDF manual". =A0I'm not sure exactly what you mean. =A0Do you mean the > user manual or the internals ("interface.tex") ? > > I think that both of these TeX documents really need to be abolished. > They're too hard to maintain so they have rotted; even if we were to > fix that they wouldn't stay up to date. I was meaning the interface document. My current work involves interacting with almost all parts of that document, so giving C examples was very easy for me and I thought it would be very helpful for new developers in the future. There are not many resources for new developers and Xen has a big entry barrier due to its size and complexity. For example there is no official guide on how to build Xen on a new system, and it took me several days to have a working system. When developing code, in my case most of the needed documentation came from The Definitive Guide to Xen Hypervisor from PrenticeHall Press. But its becoming outdated now, sadly. And in some few cases it is very general and lack much needed detail. I do understand that Xen is huge and making a easy guide for everything is impractical. Let me know how I can help, I really do want to help. > > I have volunteered to do some manpage-style or markdown docs for xl. > > Ian. > --=20 +-=3D=3D=3D=3D=3D---------------------------+ | +---------------------------------+ | This space intentionally blank for notetaking. | |=A0=A0 | Daniel Castro,=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 | | |=A0=A0 | Consultant/Programmer.| | |=A0=A0 | U Andes=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=A0 | +-------------------------------------+