On Tue, Oct 05, 2021 at 03:24:06PM +0100, Stefan Hajnoczi wrote:
> On Tue, Oct 05, 2021 at 04:11:54PM +0200, Kashyap Chamarthy wrote:
[...]
> > They were linked to from the SubmitAPatch page. I thought having one
> > doc in qemu.git and the other two related docs on the Wiki was clunky.
> > I can leave them on the Wiki as-is. But I thought upstream is wants to
> > move away from the Wiki to in-tree docs where it makes sense.
>
> I meant SubmitAPatch too :). I may have forgotten or missed the IRC
> discussion so I wanted to understand the reason.
I converted it based on ththe following chat with Peter on #qemu, OFTC.
This was on 22Sep2021 (if you have the IRC log archives). I agree with
Peter, SubmitAPatch doc should be in-tree:
...
<pm215> (we absolutely do have stuff on the wiki that should be in
the docs, eg the networking page)
<pm215> the "how to contribute a patch" page ought to be in
docs/devel/
<danpb> all the platform specific build guides should be too
...
Then, Peter and DanPB pointed more sources of unmaintained docs:
- All the pages under https://wiki.qemu.org/Documentation - Peter
suggests to incorporate them information into the actual
documentation in docs/.
- The "Feature" pages:
https://wiki.qemu.org/Special:AllPages. DanPB asked how many of
them are actually accurate. As some of them go back to 10 years.
- Then there are the "lonely pages (pointed out by Peter):
https://wiki.qemu.org/Special:LonelyPages - these are
unreachable. DanPB noted that there are 151 "lonely pages". This
doesn't mean they're obsolete, though - some of them were written in
2021.
--
/kashyap
