Re: [Xen-devel] [PATCH] xl: Special case tap/aio for disk validation

[Ian Jackson <Ian.Jackson@xxxxxxxxxxxxx>]

Ian Campbell writes ("Re: [Xen-devel] [PATCH] xl: Special case tap/aio for disk 
validation"):
> I'm not sure if the canonical place for this sort of thing should be the
> wiki (where it is simple for anyone to update, but where it might get
> out of date or suffer from version skew etc) or in-tree (where we can
> patch as part of the implementation of new features).

There should be primary reference documentation, of every syntax,
public interface, and feature, in-tree.  This should be in plain text
files or perhaps manpages or something equally easy to edit and view.

That way we can require people who add new features to update the
documentation, and users will have the documentation which corresponds
to the code that they have.

> I'd be inclined to suggest we take that wiki page, text-ify it, sanity
> check for updatedness, stick it in the tree and update the wiki to
> reference it. Opinions?

That would be a good start.  NB that there's also the xm-config.5
manpage.  All of this needs to be unified.

Ian.

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