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



Reply via email to