[libvirt] documentation request

[Igor Serebryany]

I'd like to make a request to the people on here to change
the way documentation is done when libvirt is changed. I'd love to see
two things in the documentation with every change:

1) Version tracking -- every feature that's added should always list
which version it was added in

2) Examples -- especially for the changes to domain XML, every new
attribute should be demonstrated in the example box for that section

To pick a random example, there's the new cpushares and vcpupin
attributes. Looking here:
http://libvirt.org/formatdomain.html#elementsResources neither of them
is listed in the example box. vcpupin has a pretty complicated syntax,
and the only way to figure out what it is is to dig through list
archives. Also, users might become really confused when these features
fail to do anything on versions of libvirt < 0.9.0.

....

Actually, digging further I noticed that Osier Yang actually did write
an example section:
http://www.redhat.com/archives/libvir-list/2011-March/msg01342.html
but it fell away by the time his change was pushed (commit 6b3644).

--Igor
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20110512/c1a6af73/attachment-0001.sig>