From: Paul Brook <paul@codesourcery.com>
To: qemu-devel@nongnu.org
Subject: Re: [Qemu-devel] [RFC] wiki.qemu.org
Date: Thu, 25 Feb 2010 13:50:08 +0000 [thread overview]
Message-ID: <201002251350.09047.paul@codesourcery.com> (raw)
In-Reply-To: <4B633A80.100@codemonkey.ws>
> 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.
I think removing the official documentation to the wiki would be a bad idea.
Anyone shipping qemu needs documentation that matches the version they're
actually shipping. In particular I'd expect significant discrepancies between
master and the various stable branches, so we need versioned documentation. A
Wiki seems a poor solution to this. It's also very useful to be able to ship
html/pdf versions of the documentation for offline use. I'm not sure how
feasible this is with wiki based documentation.
I'm happy for things like FAQs, howtos, internals documentation, explanation
of design choices, etc. to be on the wiki.
Paul
prev parent reply other threads:[~2010-02-25 13:50 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-01-29 19:44 [Qemu-devel] [RFC] wiki.qemu.org Anthony Liguori
2010-01-29 20:23 ` Scott Tsai
2010-01-29 20:29 ` Andreas Färber
2010-01-29 20:53 ` Anthony Liguori
2010-01-29 21:47 ` Stefan Weil
2010-01-29 22:35 ` Anthony Liguori
2010-02-25 13:50 ` Paul Brook [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=201002251350.09047.paul@codesourcery.com \
--to=paul@codesourcery.com \
--cc=qemu-devel@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).