From 4bb4fd429089dd97a268ddfab42d36432b53de21 Mon Sep 17 00:00:00 2001 From: Emily Shaffer Date: Fri, 24 Jan 2020 13:26:02 -0800 Subject: [PATCH 1/2] MyFirstContribution: add avenues for getting help With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we now have a mentoring mailing list, to which we should direct new contributors who have questions. Mention #git-devel, which is targeted for Git contributors; asking for help with getting a first contribution together is on-topic for that channel. Also mention some of the conventions in case folks are unfamiliar with IRC. Because the mentoring list and #git-devel are both a subset of Git contributors, finally list the main Git list and mention some of the posting conventions. Signed-off-by: Emily Shaffer Signed-off-by: Junio C Hamano --- Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt index 35b9130aa3..522c75099d 100644 --- a/Documentation/MyFirstContribution.txt +++ b/Documentation/MyFirstContribution.txt @@ -23,6 +23,39 @@ useful additional context: - `Documentation/SubmittingPatches` - `Documentation/howto/new-command.txt` +[[getting-help]] +=== Getting Help + +If you get stuck, you can seek help in the following places. + +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com] + +This mailing list is targeted to new contributors and is a great place to post +questions and receive kind, detailed answers from volunteers on the Git +project. You must join the group to view messages or post. + +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode + +This IRC channel is for conversations between Git contributors. If someone is +currently online and knows the answer to your question, you can receive help +in real time. Otherwise, you can read the +https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see +whether someone answered you. IRC does not allow offline private messaging, so +if you try to private message someone and then log out of IRC, they cannot +respond to you. It's better to ask your questions in the channel so that you +can be answered if you disconnect and so that others can learn from the +conversation. + +==== git@vger.kernel.org + +This is the main Git project mailing list where code reviews, version +announcements, design discussions, and more take place. The Git list +requires plain-text-only emails and prefers inline and bottom-posting when +replying to mail; you will be CC'd in all replies to you. Optionally, you can +subscribe to the list by sending an email to majordomo@vger.kernel.org with +"subscribe git" in the body. The https://lore.kernel.org/git[archive] of this +mailing list is available to view in a browser. + [[getting-started]] == Getting Started From a2dc43414c2ab480a923b1f8afdb61e005e97ef6 Mon Sep 17 00:00:00 2001 From: Emily Shaffer Date: Thu, 13 Feb 2020 18:03:59 -0800 Subject: [PATCH 2/2] MyFirstContribution: rephrase contact info Make an effort not to discourage new users from mailing questions to git@vger.kernel.org, and explain the purpose of the mentoring list in contrast to the main list. Signed-off-by: Emily Shaffer Reviewed-by: Jonathan Nieder Signed-off-by: Junio C Hamano --- Documentation/MyFirstContribution.txt | 29 +++++++++++++++------------ 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt index 522c75099d..427274df4d 100644 --- a/Documentation/MyFirstContribution.txt +++ b/Documentation/MyFirstContribution.txt @@ -28,11 +28,24 @@ useful additional context: If you get stuck, you can seek help in the following places. +==== git@vger.kernel.org + +This is the main Git project mailing list where code reviews, version +announcements, design discussions, and more take place. Those interested in +contributing are welcome to post questions here. The Git list requires +plain-text-only emails and prefers inline and bottom-posting when replying to +mail; you will be CC'd in all replies to you. Optionally, you can subscribe to +the list by sending an email to majordomo@vger.kernel.org with "subscribe git" +in the body. The https://lore.kernel.org/git[archive] of this mailing list is +available to view in a browser. + ==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com] -This mailing list is targeted to new contributors and is a great place to post -questions and receive kind, detailed answers from volunteers on the Git -project. You must join the group to view messages or post. +This mailing list is targeted to new contributors and was created as a place to +post questions and receive answers outside of the public eye of the main list. +Veteran contributors who are especially interested in helping mentor newcomers +are present on the list. In order to avoid search indexers, group membership is +required to view messages; anyone can join and no approval is required. ==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode @@ -46,16 +59,6 @@ respond to you. It's better to ask your questions in the channel so that you can be answered if you disconnect and so that others can learn from the conversation. -==== git@vger.kernel.org - -This is the main Git project mailing list where code reviews, version -announcements, design discussions, and more take place. The Git list -requires plain-text-only emails and prefers inline and bottom-posting when -replying to mail; you will be CC'd in all replies to you. Optionally, you can -subscribe to the list by sending an email to majordomo@vger.kernel.org with -"subscribe git" in the body. The https://lore.kernel.org/git[archive] of this -mailing list is available to view in a browser. - [[getting-started]] == Getting Started