Re: [PATCH v2 2/3] docs: rSTify MailingLists wiki; move it to QEMU Git

["Philippe Mathieu-Daudé" <philippe.mathieu.daude@gmail.com>]

Hi Kashyap,

On 14/3/22 11:49, Kashyap Chamarthy wrote:
> This document is referred to from the GettingStartedDevelopers wiki
> which will be rSTified in a follow-up commit.
> 
> Converted from Mediawiki to rST using:
> 
>      $> pandoc -f Mediawiki -t rst MailingLists.wiki
>          -o mailing-lists.rst
> 
> It's a 1-1 conversion (I double-checked to the best I could).  I've also
> checked that the hyperlinks work correctly post-conversion.
> 
> Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
> ---
>   docs/devel/index.rst         |  1 +
>   docs/devel/mailing-lists.rst | 53 ++++++++++++++++++++++++++++++++++++
>   2 files changed, 54 insertions(+)
>   create mode 100644 docs/devel/mailing-lists.rst

> diff --git a/docs/devel/mailing-lists.rst b/docs/devel/mailing-lists.rst
> new file mode 100644
> index 0000000000..53dcbfb007
> --- /dev/null
> +++ b/docs/devel/mailing-lists.rst
> @@ -0,0 +1,53 @@
> +.. _mailing-lists:
> +
> +Mailing lists
> +=============
> +
> +-  `QEMU developers mailing
> +   list <http://lists.nongnu.org/mailman/listinfo/qemu-devel>`__
> +-  `QEMU stable mailing
> +   list <http://lists.nongnu.org/mailman/listinfo/qemu-stable>`__
> +-  `QEMU trivial patch mailing
> +   list <http://lists.nongnu.org/mailman/listinfo/qemu-trivial>`__
> +-  `QEMU users mailing
> +   list <http://lists.nongnu.org/mailman/listinfo/qemu-discuss>`__

This is a fair conversion from 
https://wiki.qemu.org/Contribute/MailingLists, but a good opportunity to 
improve (could be on top).

We could sort as:

  * qemu-discuss

    Meant for users. Ideally help should point at Documentation link,
    and in case of missing doc we should add it or at least a GitLab
    @Documentation ticket.

  * qemu-devel

    Meant for developers. "All patches must be sent there".

    Then developer sub-lists:

    - qemu-trivial

    - qemu-stable (this is kinda borderline, security issue fixes should
      Cc this list, however it has to be treated as a write-only list
      - a way to tag patches - no discussion happens there).

    - susbsystem specific

      > block layer

      > architecture specific

        . ARM
        . PPC
        . ...

> +.. _subsystem_specific_lists:
> +
> +Subsystem Specific Lists
> +------------------------
> +
> +These exist to make it a little easier to follow subsystem specific
> +patches. You should however continue to CC qemu-devel so your series
> +gets wide visibility.
> +
> +-  `QEMU ARM mailing
> +   list <https://lists.nongnu.org/mailman/listinfo/qemu-arm>`__
> +-  `QEMU block devices mailing
> +   list <https://lists.nongnu.org/mailman/listinfo/qemu-block>`__
> +-  `QEMU PowerPC mailing
> +   list <https://lists.nongnu.org/mailman/listinfo/qemu-ppc>`__
> +-  `QEMU RISC-V mailing
> +   list <https://lists.nongnu.org/mailman/listinfo/qemu-riscv>`__
> +-  `QEMU s390x mailing
> +   list <https://lists.nongnu.org/mailman/listinfo/qemu-s390x>`__