Re: [PATCH v2 0/6] rSTify contribution-related wiki pages

[Kashyap Chamarthy <kchamart@redhat.com>]

On Mon, Nov 08, 2021 at 04:16:56PM +0100, Thomas Huth wrote:
> On 02/11/2021 16.51, Kashyap Chamarthy wrote:
> > On Mon, Nov 01, 2021 at 02:56:43PM +0000, Peter Maydell wrote:
> > > On Tue, 19 Oct 2021 at 10:04, Kashyap Chamarthy <kchamart@redhat.com> wrote:
> > > > 
> > > > My main motivation was to convert SubmitAPatch[1] based on a chat with
> > > > Peter Maydell and Dan Berrangé on #qemu channel (on OFTC).  But the page
> > > > also links to a couple of other contribution-related pages, so I
> > > > converted them too:
> > > > 
> > > >    - SubmitAPullRequest: https://wiki.qemu.org/Contribute/SubmitAPullRequest
> > > >    - KeySigningParty: https://wiki.qemu.org/KeySigningParty
> > > >    - SpellCheck: https://wiki.qemu.org/Contribute/SpellCheck
> > > >    - TrivialPatches: https://wiki.qemu.org/Contribute/TrivialPatches
> > > 
> > > I'm not sure that SpellCheck in particular is sufficiently baked
> > > to be in the actual docs. I'd rather just drop the reference to it
> > > from SubmitAPatch.
> > 
> > Sure, will drop.
> > 
> > > KeySigningParty I'm on the fence about.
> > 
> > This is linked only from the SubmitAPullRequest page.  If we're
> > ambivalent about it, I'll just keep it in for reference.
> 
> FWIW, I'd rather prefer to keep the KeySigningParty stuff in the wiki - it
> does not feel like the right content for the docs that we ship in the
> release tarballs.

Sure, I can leave it on the Wiki as-is.  I thought of keeping it in-tree
as it's a developer- and maintainer-related doc; and to minimize using
the Wiki for important docs such as these.  As we know, being in-tree is
likely to receive updates.  Also ... I'm not sure how many regular users
downloading the tarball will read the docs/devel/ directory. :-)

(/me wonders if there's a way to selectively "uncheck" certain docs when
building the tarball.)

-- 
/kashyap