Re: [Qemu-devel] [PATCH 00/30] Move qapi documentation to schema (part 2/5)

[Eric Blake]

On 09/22/2016 04:22 AM, Marc-André Lureau wrote:
> Hi,
> 
> The QAPI documentation is currently done in two places, the json
> schema and a more human-friendly text file. The goal is to avoid
> duplication and to generate friendly versions from the schema (pdf,
> man etc).  Thus, all documentation should be moved to the schema.
> 
> In order to facilitate the review, the documentation move has been
> splitted, and is going to sent by chunks of ~30 patches. This way it

s/splitted/split/

> should take about 5 series to complete (~150 patches). I suggest that
> the qapi maintainers (Markus/Eric) compile the reviewed patches in a
> branch and merge upstream in one go (either merging move commits or
> not) when the series complete and the documentation is finally
> generated to avoid an in-between state.

I don't mind an in-between state, as long as the commit message is clear
that more patches are required to bring the docs back up to quality.  It
doesn't break bisection to have incomplete documentation.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

signature.asc
Description: OpenPGP digital signature