[libvirt] Publishing a Python libvirt Howto/Reference Guide

[Michal Privoznik]

On 15.06.2015 17:48, David Ashley wrote:
> All -
> 
> I represent the Fedora Docs Team. We are interested in publishing a
> Python libvirt HowTo/Reference Guide for users. We feel that there is a
> gap with using virtualization from a scripting environment. While virsh
> fills this gap for simple scripting purposes, a more powerful scripting
> language is needed for deep administrative purposes. Python is the
> obvious choice and the libvirt team has provided a great Python module.
> What is really missing are examples of using the module in both simple
> and deeper tasks i.e. something more than just how to start and stop a
> domain.
> 
> We propose to create such a document. While we can use pydoc to create
> the reference material, we need some really good examples that can teach
> a user how to get real work done using the classes. We also propose to
> share the document with the libvirt team taking either an upstream or
> downstream role in maintaining the document. The document would be
> written in DocBook and published using the Publican system. This would
> allow you to create your own brand for the document (look and feel)
> while maintaining compatible source for both our teams. It would also
> allow the source to be maintained by both teams.
> 
> If this sounds interesting to you we would like to begin our planning
> for the document in the near future with one or more representatives
> from the libvirt team on board. Please let either myself or Laura Novich
> (cc'ed on this email) know if this proposal meets with your approval.
> 

I appreciate any kind of documentation work. If sent, I'll review the
patches too. Also, there's examples/ folder which contains I'd say small
and medium examples:

http://libvirt.org/git/?p=libvirt-python.git;a=tree;f=examples;h=16c5795a3d6f7d5deb7cdf8ab27fb3f958e3f963;hb=HEAD

Michal