]> git.ipfire.org Git - thirdparty/libvirt.git/commit
docs: attempt to document the general libvirt dev strategy
authorDaniel P. Berrangé <berrange@redhat.com>
Thu, 19 Sep 2019 11:48:15 +0000 (12:48 +0100)
committerDaniel P. Berrangé <berrange@redhat.com>
Tue, 1 Oct 2019 12:08:01 +0000 (13:08 +0100)
commit557ac8cbf54054de1372e45041dd54037ef26c07
treed2587cdbfcf7327347fe797d8afe4c98053372ea
parent76d31244c5ca52d05f2fefaf7be55caf2169c470
docs: attempt to document the general libvirt dev strategy

There are various ideas / plans floating around for future libvirt work,
some of which is actively in progress. Historically we've never captured
this kind of information anywhere, except in mailing list discussions.
In particular guidelines in hacking.html.in don't appear until a policy
is actively applied.

This patch attempts to fill the documentation gap, by creating a new
"strategy" page which outlines the general vision for some notable
future changes. The key thing to note is that none of the stuff on this
page is guaranteed, plans may change as new information arises. IOW this
is a "best guess" as to the desired future.

This doc has focused on three areas, related to the topic of language
usage / consolidation

 - Use of non-C languages for the library, daemons or helper tools
 - Replacement of autotools with meson
 - Use of RST and Sphinx for documentation (website + man pages)

Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
docs/docs.html.in
docs/strategy.html.in [new file with mode: 0644]