With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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, it's possible that no response is found on either forum,
so list the main mailing list as a fallback and mention some of the
conventions.
Signed-off-by: Emily Shaffer <redacted>
---
Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
@@ -23,6 +23,38 @@ 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.++==== https://public-inbox.org/git[git@vger.kernel.org]++This is the main Git project mailing list where code reviews, version+announcements, design discussions, and more take place. If you fail to receive+help via the channels above, you can ask your question here. You can join by+sending an email to majordomo@vger.kernel.org with "subscribe git" in the body.+The Git list requires plain-text-only emails and prefers inline and+bottom-posting when replying to mail.+ [[getting-started]] == Getting Started
From: Denton Liu <hidden> Date: 2019-11-15 22:05:33
Hi Emily,
On Fri, Nov 15, 2019 at 01:53:42PM -0800, Emily Shaffer wrote:
quoted hunk
With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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, it's possible that no response is found on either forum,
so list the main mailing list as a fallback and mention some of the
conventions.
Signed-off-by: Emily Shaffer <redacted>
---
Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
@@ -23,6 +23,38 @@ 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.++==== https://public-inbox.org/git[git@vger.kernel.org]++This is the main Git project mailing list where code reviews, version+announcements, design discussions, and more take place. If you fail to receive+help via the channels above, you can ask your question here. You can join by+sending an email to majordomo@vger.kernel.org with "subscribe git" in the body.+The Git list requires plain-text-only emails and prefers inline and+bottom-posting when replying to mail.
Perhaps we could explicitly mention that subscribing to the list is
optional and not required to post (especially since we CC everyone
here)? New contributors may be intimidated by the volume of mail going
through here so knowing that they don't have to subscribe might be
helpful.
Thanks,
Denton
+
[[getting-started]]
== Getting Started
--
2.24.0.432.g9d3f5f5b63-goog
On Fri, Nov 15, 2019 at 02:05:28PM -0800, Denton Liu wrote:
Hi Emily,
On Fri, Nov 15, 2019 at 01:53:42PM -0800, Emily Shaffer wrote:
quoted
+==== https://public-inbox.org/git[git@vger.kernel.org]
+
+This is the main Git project mailing list where code reviews, version
+announcements, design discussions, and more take place. If you fail to receive
+help via the channels above, you can ask your question here. You can join by
+sending an email to majordomo@vger.kernel.org with "subscribe git" in the body.
+The Git list requires plain-text-only emails and prefers inline and
+bottom-posting when replying to mail.
Perhaps we could explicitly mention that subscribing to the list is
optional and not required to post (especially since we CC everyone
here)? New contributors may be intimidated by the volume of mail going
through here so knowing that they don't have to subscribe might be
helpful.
Yeah, good idea. I'll move the plaintext/posting order rules sentence in
front of the majordomo sentence, and add "optionally" to the beginning
of the majordomo sentence. Thanks.
- Emily
With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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, it's possible that no response is found on either forum,
so list the main mailing list as a fallback and mention some of the
conventions.
Signed-off-by: Emily Shaffer <redacted>
---
Reworded the Git mailing list blurb per Denton's recommendation.
Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++
1 file changed, 33 insertions(+)
@@ -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.++==== https://public-inbox.org/git[git@vger.kernel.org]++This is the main Git project mailing list where code reviews, version+announcements, design discussions, and more take place. If you fail to receive+help via the channels above, you can ask your question 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.+ [[getting-started]] == Getting Started
From: Johannes Schindelin <hidden> Date: 2019-11-15 23:38:59
Hi Emily,
On Fri, 15 Nov 2019, Emily Shaffer wrote:
With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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, it's possible that no response is found on either forum,
so list the main mailing list as a fallback and mention some of the
conventions.
Signed-off-by: Emily Shaffer <redacted>
---
Looks good to me.
Thanks!
Dscho
quoted hunk
Reworded the Git mailing list blurb per Denton's recommendation.
Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++
1 file changed, 33 insertions(+)
@@ -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.++==== https://public-inbox.org/git[git@vger.kernel.org]++This is the main Git project mailing list where code reviews, version+announcements, design discussions, and more take place. If you fail to receive+help via the channels above, you can ask your question 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.+ [[getting-started]] == Getting Started--
@@ -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.
+
+==== https://public-inbox.org/git[git@vger.kernel.org]
+
+This is the main Git project mailing list where code reviews, version
+announcements, design discussions, and more take place. If you fail to receive
+help via the channels above, you can ask your question 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.
+
Very nice.
Reviewed-by: Jonathan Nieder <redacted>
Thanks.
With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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 <redacted>
---
Since v2:
- Removed a double slash in a URL
- public-inbox -> lore.kernel.org
- Removed indication that Git list should be a fallback; instead, treat
it as equally useful for first attempt at Q&A.
As for the conversation which spun off regarding the access controls on
git-mentoring list, since the list still hasn't seen traffic, I'm going
to keep them as they are for a little longer.
- Emily
Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
@@ -23,6 +23,38 @@ 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.++==== https://lore.kernel.org/git[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.+ [[getting-started]] == Getting Started
We are trying to move to lore.kernel.org, I think.
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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 <redacted>
---
Since v2:
- Removed a double slash in a URL
- public-inbox -> lore.kernel.org
Ah, I see you mentioned it here and in the contents. Commit messages
are harder to keep straight, in my experience.
We are trying to move to lore.kernel.org, I think.
Argh, and I even wordsmithed a few paragraphs down in this commit
message too. Sending..
quoted
now have a mentoring mailing list, to which we should direct new
contributors who have questions.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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 <redacted>
---
Since v2:
- Removed a double slash in a URL
- public-inbox -> lore.kernel.org
Ah, I see you mentioned it here and in the contents. Commit messages
are harder to keep straight, in my experience.
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.
Since #git-devel's traffic is fairly low, it should be OK to direct some
questions there too. 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 <redacted>
---
Only difference from v3 is the public-inbox -> lore.kernel in the commit
message. Thanks, Stolee.
- Emily
Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
@@ -23,6 +23,38 @@ 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.++==== https://lore.kernel.org/git[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.+ [[getting-started]] == Getting Started
From: Emily Shaffer <redacted>
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 <redacted>
---
On v3, Junio mentioned changing the justification for suggesting
#git-devel in the commit-message. Stolee mentioned a missed reference to
public-inbox.org which was fixed in v4, but I mangled the threading, so
I'll also move this one to reply to v3 instead of the
in-thread-with-Stolee v4.
- Emily
Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
@@ -23,6 +23,38 @@ 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.++==== https://lore.kernel.org/git[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.+ [[getting-started]] == Getting Started
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 <redacted>
---
Since v5, let the mailing list reference resolve to a mailto instead and
added an explicit link to the (read-only) archives.
- Emily
Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++
1 file changed, 33 insertions(+)
@@ -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. You can also browse the+https://lore.kernel.org/git[archives] in your browser.+ [[getting-started]] == Getting Started
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 <redacted>
---
Took a slightly modified version of Junio's suggestion for the archive
link so the final text reads "The archive of this mailing list is
available to view in a browser" instead of "The archive of this mailing
list is available at archive to view in a browser".
- Emily
Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++
1 file changed, 33 insertions(+)
@@ -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
Why should a supposedly "open" open source project direct new
contributors to a mailing list that is not openly accessible, and even
reading and searching its archives requires registration?