diff mbox series

[1/1] docs/manual/contribute.adoc: mention mailing list subscription requirement

Message ID 20241122174608.12470-1-kiryushin@ancud.ru
State New
Headers show
Series [1/1] docs/manual/contribute.adoc: mention mailing list subscription requirement | expand

Commit Message

Nikita Kiryushin Nov. 22, 2024, 5:46 p.m. UTC 
The mail address used to contribute via buildroot mailing list
is required to be subscribed to the mailing list. Otherwise,
messages sent to the mailing list will be automatically rejected,
as server only accepts email from mailing list subscribers.

This behavior is not explicitly stated in the documentation
for contributors (aside from recommendation to subscribe
as the first thing for contributor to do). This may lead to an
unpleasent surprise to developers, who prefer reading mailing
lists using archives.

Add mention of mailing list subscription requirement to 'Preparing
a patch series' section of contribution manual.

Signed-off-by: Nikita Kiryushin <kiryushin@ancud.ru>
---
 docs/manual/contribute.adoc | 3 +++
 1 file changed, 3 insertions(+)
diff mbox series

Patch

diff --git a/docs/manual/contribute.adoc b/docs/manual/contribute.adoc
index ffaff6f857..8de0520667 100644
--- a/docs/manual/contribute.adoc
+++ b/docs/manual/contribute.adoc
@@ -375,6 +375,9 @@  $ git send-email origin/master
 Note that +git+ should be configured to use your mail account.
 To configure +git+, see +man git-send-email+ or https://git-send-email.io/.
 
+The mail account used has to be subscribed to the mailing list,
+otherwise your message will be automatically rejected.
+
 If you do not use +git send-email+, make sure posted *patches are not
 line-wrapped*, otherwise they cannot easily be applied. In such a case,
 fix your e-mail client, or better yet, learn to use +git send-email+.