[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.
Paolo
- [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, G 3, 2017/01/26
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Paolo Bonzini, 2017/01/26
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, G 3, 2017/01/26
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project,
Paolo Bonzini <=
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Peter Maydell, 2017/01/26
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Markus Armbruster, 2017/01/27
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Peter Maydell, 2017/01/27
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Stefan Hajnoczi, 2017/01/30
- Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Markus Armbruster, 2017/01/30
Re: [Qemu-devel] Qemu-devel] Poll on QEMU documentation project, Cornelia Huck, 2017/01/26