CONTRIBUTING: Add more information about the mailing list

Put the 'Mailing list' section the first one, since it's the most
important, and rewrite it to be more informative (so we don't need
to redirect to the website for everything).  Also reorganize a
little bit around that change.

Reported-by: Jakub Wilk <jwilk@jwilk.net>
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

diff --git a/CONTRIBUTING b/CONTRIBUTING
index 3685af8314d1b5ec3538d7125747208b612f8fd0..5289fa6ff43ec5b85257ecb225bb122c7248e1a5 100644 (file)
--- a/CONTRIBUTING
+++ b/CONTRIBUTING
@@ -1,8 +1,16 @@
-If you have corrections and additions to suggest, or
-for general information about how to contribute, see
-<http://www.kernel.org/doc/man-pages/contributing.html>
-(Although there is a mirror of this repository on GitHub,
-please don't report issues via the GitHub issue tracker!)
+Mailing list
+============
+The main discussion regarding development of the project, patches,
+bugs, news, doubts, etc. happens on the mailing list.  To send
+mail to the project, send an email to both maintainers and CCing
+the mailing list:
+
+    To: Alejandro Colomar <alx.manpages@gmail.com>
+    To: Michael Kerrisk <mtk.manpages@gmail.com>
+    Cc: <linux-man@vger.kernel.org>
+
+For consulting the archives of the mailing list, see:
+<https://lore.kernel.org/linux-man/>
 
 Patches
 =======
@@ -21,7 +29,10 @@ Reporting bugs
 For information about reporting bugs, see:
 <https://www.kernel.org/doc/man-pages/reporting_bugs.html>
 
-Mailing list
-============
-Email: <linux-man@vger.kernel.org>
-Archives: <https://lore.kernel.org/linux-man/>
+Other
+=====
+
+For more information about how to contribute, see
+<http://www.kernel.org/doc/man-pages/contributing.html>.
+(Although there is a mirror of this repository on GitHub,
+please don't report issues via the GitHub issue tracker!)