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