Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

[Anthony Liguori]

On 11/15/2011 12:06 PM, Stefan Weil wrote:
> Am 15.11.2011 14:44, schrieb Anthony Liguori:
> Markdown is nice for separated specs and README files,
> but is it also possible to create a complete printed manual
> from all markdown files?

I think high quality information beats pretty formatting any day.  The problem I 
see with our current documentation strategy is that it's very monolithic (one 
big printed manual) and it's in a format that many people consider obscure.

I think small stand alone documents that are easy to author are going to result 
in a better end user experience than one big document with pretty formatting.

Regards,

Anthony Liguori

> I thought of a different solution: keep qemu-doc.texi and qemu-tech.texi
> and integrate texi files made from markdown files (with pandoc) into
> these two documents to get complete manuals.
>
> Regards,
>
> Stefan Weil