commit: db994e935d3421bbfe2c1934303a369e7e4cea35 Author: Michał Górny <mgorny <AT> gentoo <DOT> org> AuthorDate: Sun May 30 09:35:28 2021 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Fri Jun 24 18:46:07 2022 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=db994e93
Describe mailing lists used by developers Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> general-concepts/mailing-lists/text.xml | 80 +++++++++++++++++++++++++++++++++ general-concepts/text.xml | 1 + 2 files changed, 81 insertions(+) diff --git a/general-concepts/mailing-lists/text.xml b/general-concepts/mailing-lists/text.xml new file mode 100644 index 0000000..4bc7b7d --- /dev/null +++ b/general-concepts/mailing-lists/text.xml @@ -0,0 +1,80 @@ +<?xml version="1.0"?> +<guide self="general-concepts/mailing-lists/"> +<chapter> +<title>Mailing Lists</title> +<body> + +<p> +Mailing lists are the most important communication media in Gentoo. +They are used to announce events, discuss changes, review code. Use +of mailing lists is explicitly required by some of the processes such +as package last rites. +</p> + +<p> +The complete list of Gentoo mailing lists can be found in the +<uri link="https://www.gentoo.org/get-involved/mailing-lists/";>mailing +list</uri> section of the Gentoo website. All mailing lists are +archived. The archives for the public lists can be found on +the <uri link="https://archives.gentoo.org/";>mailing list archives</uri> +site. The data from the non-public archives can be provided +by the Infrastructure team at the request of a developer. +</p> +</body> + +<section> +<title>Primary developer mailing lists</title> +<body> + +<p> +There are five primary lists intended for Gentoo developers +(and contributors): +</p> + +<ul> + <li>gentoo-core — internal non-public Gentoo developer list</li> + <li>gentoo-dev — public technical discussion list</li> + <li>gentoo-dev-announce — developer announcement list</li> + <li>gentoo-nfp — Gentoo Foundation discussion list</li> + <li>gentoo-project — public non-technical discussion list</li> +</ul> + +<p> +Most of the discussions take place on the gentoo-dev and gentoo-project +mailing lists. Strictly technical topics (e.g. ebuild development, +system behavior) go into gentoo-dev, while non-technical topics +(e.g. organizational matters) go into gentoo-project. Both lists are +public and open to everyone. Developers are strongly encouraged +to follow these lists. +</p> + +<p> +The gentoo-nfp list is used for affairs strictly related to the Gentoo +Foundation. For example, this includes funding and legal affairs. +</p> + +<p> +The gentoo-dev-announce is used for important announcements that affect +developers, for example major policy changes, project news. This list +is also used to announce last rites and packages needing new +maintainers. gentoo-dev-announce is not meant to accept replies, so +all messages sent to it must be cross-posted to another mailing list +and have their Reply-To header set to that list. Messages without Reply-To +are rejected, the remaining messages are moderated to prevent accidental +replies from coming through. +</p> + +<p> +The gentoo-core mailing list is restricted to developers. +It is generally used when developers wish to share information regarding +their personal situation with other developers and to discuss sensitive +matters that cannot be published at the time. The list is non-public +and it is forbidden to publicly discuss messages from -core, forward +them or cross-post to another mailing list. All developers are +subscribed to it. +</p> + +</body> +</section> +</chapter> +</guide> diff --git a/general-concepts/text.xml b/general-concepts/text.xml index 90a8d0f..cb2083a 100644 --- a/general-concepts/text.xml +++ b/general-concepts/text.xml @@ -30,6 +30,7 @@ writing ebuilds or working with the Gentoo repository. <include href="git-to-rsync/"/> <include href="install-destinations/"/> <include href="licenses/"/> +<include href="mailing-lists/"/> <include href="manifest/"/> <include href="mirrors/"/> <include href="news/"/>
