[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH 00/30] Move qapi documentation to schema (part 2
From: |
Eric Blake |
Subject: |
Re: [Qemu-devel] [PATCH 00/30] Move qapi documentation to schema (part 2/5) |
Date: |
Thu, 22 Sep 2016 08:12:53 -0500 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.3.0 |
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
- [Qemu-devel] [PATCH 21/30] qmp-commands: move 'dump-guest-memory' doc to schema, (continued)
- [Qemu-devel] [PATCH 21/30] qmp-commands: move 'dump-guest-memory' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 22/30] qmp-commands: move 'query-dump-guest-memory-capability' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 23/30] qmp-commands: move 'dump-skeys' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 24/30] qmp-commands: move 'netdev_add' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 25/30] qmp-commands: move 'netdev_del' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 26/30] qmp-commands: move 'object-add' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 27/30] qmp-commands: move 'object-del' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 28/30] qmp-commands: move 'getfd' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 29/30] qmp-commands: move 'closefd' doc to schema, Marc-André Lureau, 2016/09/22
- [Qemu-devel] [PATCH 30/30] qmp-commands: move 'add-fd' doc to schema, Marc-André Lureau, 2016/09/22
- Re: [Qemu-devel] [PATCH 00/30] Move qapi documentation to schema (part 2/5),
Eric Blake <=