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/
Home Products Support Community News


Re: [Xen-users] Xen documentation are still too old

To: Denny Schierz <linuxmail@xxxxxxxx>
Subject: Re: [Xen-users] Xen documentation are still too old
From: Tim Post <echo@xxxxxxxxxxxx>
Date: Sat, 22 Nov 2008 09:10:39 +0800
Cc: xen-users <xen-users@xxxxxxxxxxxxxxxxxxx>
Delivery-date: Fri, 21 Nov 2008 17:11:36 -0800
Envelope-to: www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to: <1227283041.27101.30.camel@kusanagi>
List-help: <mailto:xen-users-request@lists.xensource.com?subject=help>
List-id: Xen user discussion <xen-users.lists.xensource.com>
List-post: <mailto:xen-users@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/mailman/listinfo/xen-users>, <mailto:xen-users-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/mailman/listinfo/xen-users>, <mailto:xen-users-request@lists.xensource.com?subject=unsubscribe>
References: <1227283041.27101.30.camel@kusanagi>
Reply-to: echo@xxxxxxxxxxxx
Sender: xen-users-bounces@xxxxxxxxxxxxxxxxxxx
Hi Denny,

On Fri, 2008-11-21 at 16:57 +0100, Denny Schierz wrote:
> hi,
> i'm a real Xen user since version 2.0.7 and i still believe on the power
> and charme from Xen. I used Xen for my costumers, for my own and I'm
> proud to tell everybody about Xen, what they can do with the hypervisor
> and i've written severals German HOWTOs. But, where the sun is, the
> shadow isn't far away: Xen lacks absolutely on actual docs. The ManPages
> are still not updated (many FIXME), not all parameters are listed in
> (5), for example 

The wiki is also horribly out of date. There are two major obstacles
when documenting Xen:

1 - Xen is still a rapidly moving target
2 - Many versions of Xen are still in production use

So documentation describing Xenstore, configuration paramaters and other
things might have to remain backwards compatible. Some things have to be
marked as "Xen 3.3 Only", while others "Xen 3.0 Or Prior".

I have been going through the wiki looking for various FIXMEs and
addressing them, while preparing some new pages to add (for instance,
documenting exported sysfs attributes and statistics).

Its funny, because I was just searching for an 'official' Xen
documentation project to join in hopes of combining efforts with others
doing the same.

I really don't know if its worth trying to keep the documentation
backwards compatible all the way to 3.0 and if not, which version should
be the cut off point? 3.0.2 perhaps?


Xen-users mailing list

<Prev in Thread] Current Thread [Next in Thread>