Re: [PATCH 0/3] rSTify SubmitAPatch, TrivialPatches, and SpellCheck wiki pages

[Kashyap Chamarthy <kchamart@redhat.com>]

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