CONTRIBUTING, CONTRIBUTING.d/mail: Split file, and rewrite CONTRIBUTING as an intro

CONTRIBUTING is now an intro to all the files in CONTRIBUTING.d/

Signed-off-by: Alejandro Colomar <alx@kernel.org>

1 files changed, 13 insertions, 52 deletions

diff --git a/CONTRIBUTING b/CONTRIBUTING
index bbec6c780..f6d48e92a 100644
--- a/CONTRIBUTING
+++ b/CONTRIBUTING
@@ -6,7 +6,6 @@ Synopsis
        and more.
 
 Description
-   Mailing list
        The main discussions regarding development of the project,
        patches, bugs, news, doubts, etc. happen on the mailing list.
        To send an email to the project, send it to Alejandro and CC the
@@ -15,62 +14,24 @@ Description
            To: Alejandro Colomar <alx@kernel.org>
            Cc: <linux-man@vger.kernel.org>
 
-       Please CC any relevant developers and mailing lists that may know
-       about or be interested in the discussion.  If your email
-       discusses a feature or change, and you know which developers
-       added the feature or made the change that your email discusses,
-       please CC them on the email; with luck they may review and
-       comment on it.  If you don't know who the developers are, you may
-       be able to discover that information from mailing list archives
-       or from git(1) logs or logs in other version control systems.
-       Obviously, if you are the developer of the feature being
-       discussed in a man-pages email, please identify yourself as such.
-       Relevant mailing lists may include:
+Files
+   CONTRIBUTING.d/mail
+       Instructions for sending emails to the project
 
-           Cc: LKML <linux-kernel@vger.kernel.org>
-           Cc: Linux API <linux-api@vger.kernel.org>
-           Cc: Glibc <libc-alpha@sourceware.org>
+   CONTRIBUTING.d/patches
+       Instructions for contributing patches
 
-       For other kernel mailing lists and maintainers, check the
-       <MAINTAINERS> file in the Linux kernel repository.
+   CONTRIBUTING.d/bugs
+       Instructions for reporting bugs
 
-       Please don't send HTML email; it will be discarded by the list.
+   CONTRIBUTING.d/lint
+       Instructions for linting manual pages
 
-       Archives:
-             <https://lore.kernel.org/linux-man/>
-             <https://marc.info/?l=linux-man>
+   CONTRIBUTING.d/external_pages
+       Pages imported or generated from other projects
 
-       Subscription:
-             It is not necessary to subscribe to the list to send an
-             email.  For subscribing to the list, or information about
-             it, go to
-             <https://subspace.kernel.org/vger.kernel.org.html>.
-
-   Sign your emails with PGP
-        We encourage that you sign all of your emails sent to the
-        mailing list, (especially) including the ones containing
-        patches, with your PGP key.  This helps establish trust between
-        you and other contributors of this project, and prevent others
-        impersonating you.  If you don't have a key, it's not mandatory
-        to sign your email, but you're encouraged to create and start
-        using a PGP key.  See also:
-        <https://www.gnupg.org/faq/gnupg-faq.html#use_pgpmime>
-
-        There are many ways you can sign your patches, and it depends on
-        your preferred tools.  You can use neomutt(1) (>= 20240201) as a
-        driver for git-send-email(1).  In <~/.gitconfig>, add the
-        following section:
-
-            [sendemail]
-                sendmailcmd = neomutt -C -H - && true
+   CONTRIBUTING.d/style
+       Preferred layout of manual pages and style guide notes
 
 See also
-       CONTRIBUTING.d/bugs
-       CONTRIBUTING.d/external_pages
-       CONTRIBUTING.d/lint
-       CONTRIBUTING.d/patches
-       CONTRIBUTING.d/style
-
-       <https://www.kernel.org/doc/man-pages/linux-man-ml.html>
        <https://www.kernel.org/doc/man-pages/missing_pages.html>
-       <https://www.kernel.org/doc/man-pages/code_of_conduct.html>