CONTRIBUTING.d/mail: Recommend specific mutt(1) config
[man-pages.git] / CONTRIBUTING.d / mail
bloba749e34ffb5a2d78f7ee7b633f0716550aed439a
1 Name
2        Mail - instructions for sending email to the project
4 Description
5        The main discussions regarding development of the project,
6        patches, bugs, news, doubts, etc. happen on the mailing list.
7        To send an email to the project, send it to Alejandro and CC the
8        mailing list:
10            To: Alejandro Colomar <alx@kernel.org>
11            Cc: <linux-man@vger.kernel.org>
13        Please CC any relevant developers and mailing lists that may know
14        about or be interested in the discussion.  If your email
15        discusses a feature or change, and you know which developers
16        added the feature or made the change that your email discusses,
17        please CC them on the email; with luck they may review and
18        comment on it.  If you don't know who the developers are, you may
19        be able to discover that information from mailing list archives
20        or from git(1) logs or logs in other version control systems.
21        Obviously, if you are the developer of the feature being
22        discussed in a man-pages email, please identify yourself as such.
23        Relevant mailing lists may include:
25            Cc: LKML <linux-kernel@vger.kernel.org>
26            Cc: Linux API <linux-api@vger.kernel.org>
27            Cc: Glibc <libc-alpha@sourceware.org>
29        For other kernel mailing lists and maintainers, check the
30        <MAINTAINERS> file in the Linux kernel repository.
32        Please don't send HTML email; it will be discarded by the list.
34        Archives:
35              <https://lore.kernel.org/linux-man/>
36              <https://marc.info/?l=linux-man>
38        Subscription:
39              It is not necessary to subscribe to the list to send an
40              email.  For subscribing to the list, or information about
41              it, go to
42              <https://subspace.kernel.org/vger.kernel.org.html>.
44    Sign your emails with PGP
45         We encourage that you sign all of your emails sent to the
46         mailing list, (especially) including the ones containing
47         patches, with your PGP key.  This helps establish trust between
48         you and other contributors of this project, and prevent others
49         impersonating you.  If you don't have a key, it's not mandatory
50         to sign your email, but you're encouraged to create and start
51         using a PGP key.  See also:
52         <https://www.gnupg.org/faq/gnupg-faq.html#use_pgpmime>
54         If you use mutt(1), we recommend the following configuration for
55         PGP:
57             set crypt_autosign = yes
58             set crypt_protected_headers_write = yes
60 See also
61        CONTRIBUTING
62        CONTRIBUTING.d/*
64        <https://www.kernel.org/doc/man-pages/linux-man-ml.html>
65        <https://www.kernel.org/doc/man-pages/code_of_conduct.html>