[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project

From: Paolo Bonzini
Subject: Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project
Date: Thu, 26 Jan 2017 18:52:42 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.5.1

On 26/01/2017 18:40, G 3 wrote:
> On Jan 26, 2017, at 12:30 PM, Paolo Bonzini wrote:
>> On 26/01/2017 18:28, G 3 wrote:
>>> On Jan 26, 2017, at 12:00 PM, address@hidden wrote:
>>>> Hi all,
>>>> as you may know I've been collecting some ideas about documentation for
>>>> QEMU at http://wiki.qemu-project.org/Features/Documentation.
>>>> I've now prepared a poll to understand how familiars developers are
>>>> with
>>>> various documentation tools.  I've CCed people with most commits to
>>>> QEMU
>>>> documentation, or with whom I have discussed about this before, but
>>>> everybody's opinion is of course welcome!
>>>> The poll is hosted with Google Forms and you can fill it in at
>>>> https://goo.gl/Yfxj1M.  If you hate Google Forms, contact me offlist
>>>> and
>>>> I'll send you the questions by email (and remind you when I need
>>>> someone
>>>> to review my patches).
>>>> Paolo
>>>> tl;dr: poll is at https://goo.gl/Yfxj1M
>>> For this question:
>>> What's your opinion on the maintainability of the following
>>> documentation formats?
>>> Is it from 1(least maintainable) to 5 (most maintainable)?
>>> The survey looks good. I will take it.
>> Yes, all of them are 1=bad 5=good.
> Could we add HTML to the list of documentation formats?

Since you have mentioned that in the comments and someone else mentioned
AsciiDoc, they weren't included because:

- HTML is mostly a destination format.  With the listed formats it is
possible to produce a variety of outputs (mostly HTML itself and PDF;
secondarily text or ePub or others).

- AsciiDoc was considered by the Linux kernel folks but they complained
about the tools.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]