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

[Philippe Mathieu-Daudé]

On 10/5/21 16:24, Stefan Hajnoczi wrote:
> On Tue, Oct 05, 2021 at 04:11:54PM +0200, Kashyap Chamarthy wrote:
>> On Tue, Oct 05, 2021 at 03:01:17PM +0100, Stefan Hajnoczi wrote:
>>> On Wed, Sep 22, 2021 at 02:10:51PM +0200, Kashyap Chamarthy wrote:
>>>> As of writing this, qemu.org is down, so I've used a one-month old
>>>> copy[1] of the wiki from 27Aug2021 to do the rST conversion.
>>>>
>>>> My main motivation was to convert SubmitAPatch (when Peter Maydell
>>>> pointed out on IRC that it's still on the wiki).  But it links to a
>>>> couple more small wiki pages; so I converted them too:
>>>>
>>>>   - SpellCheck: https://wiki.qemu.org/Contribute/SpellCheck
>>>>   - TrivialPatches: https://wiki.qemu.org/Contribute/TrivialPatches
>>>
>>> What is the motivation for moving these pages from the wiki to qemu.git
>>> (https://qemu-project.gitlab.io/qemu/devel/index.html)?
>>
>> 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.

One point Peter raised on IRC is it is easier to update a Wiki page
than get a patch merged into the repository. IOW we are making things
harder.

GitLab provides a wiki for all tiers, but requires contributors to have
the Developer role to be able to modify the wiki:
https://docs.gitlab.com/ee/user/project/wiki/#edit-a-wiki-page
I suppose this is a no-go since currently it is enought having
contributors as reporters (to fill issues).

Alternative could be to have a qemu-wiki project within qemu-project
gitlab namespace, and have point to this one instead (currently we
point to the external wiki).