On Sat, Jan 30, 2010 at 3:44 AM, Anthony Liguori <anth...@codemonkey.ws> wrote: > Hi, > > I've been (slowly) working to convert qemu.org to a wiki in order to allow > more community participation in the website. I've finally got a site setup > and to my liking with all of the www.qemu.org content migrated. > > Before doing the switch, I need to figure out what to do with the current > texi documentation. I think it makes sense to move qemu-doc.texi to a wiki > page and remove it from the source repository. The other option would be to > link to it as an external page and keep it within revision control. > > Does anyone have strong opinions one way or another?
To keep the code and documentation in sync, I suggest keeping the portion generated from qemu-img-cmds.hx, qemu-monitor.hx and qemu-options.hx in texinfo format under revision control. This encourages updating the documentation in the same patch that adds new options and monitor commands. The "QEMU System emulator for non PC targets" section in qemu-doc.texi seems rather qemu version dependent as well? If true, moving this information to a wiki risks the documentation not matching the qemu version installed on users' machines.