{"thread":{"id":"52275","subject":"[PATCH] MyFirstContribution: add avenues for getting help","startedAt":"2019-11-15T21:53:50Z","lastAt":"2020-02-14T17:36:28Z","messageCount":44,"participants":["Emily Shaffer","Denton Liu","Johannes Schindelin","Jonathan Nieder","Junio C Hamano","SZEDER Gábor","Eric Wong","Kerry, Richard","Derrick Stolee","emilyshaffer@google.com"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"386342","messageId":"20191115215342.37408-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":null,"subject":"[PATCH] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-11-15T21:53:42Z","receivedAt":"2019-11-15T21:53:50Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nSince #git-devel's traffic is fairly low, it should be OK to direct some\nquestions there too. Mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, it's possible that no response is found on either forum,\nso list the main mailing list as a fallback and mention some of the\nconventions.\n\nSigned-off-by: Emily Shaffer \n---\n Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++\n 1 file changed, 32 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 5e9b808f5f..9fe197c98e 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,38 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== https://public-inbox.org/git[git@vger.kernel.org]\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. If you fail to receive\n+help via the channels above, you can ask your question here. You can join by\n+sending an email to majordomo@vger.kernel.org with \"subscribe git\" in the body.\n+The Git list requires plain-text-only emails and prefers inline and\n+bottom-posting when replying to mail.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.24.0.432.g9d3f5f5b63-goog\n\n"},{"id":"386344","messageId":"20191115220528.GA80935@generichostname","threadId":"52275","inReplyTo":"20191115215342.37408-1-emilyshaffer@google.com","subject":"Re: [PATCH] MyFirstContribution: add avenues for getting help","fromName":"Denton Liu","fromEmail":"liu.denton@gmail.com","sentAt":"2019-11-15T22:05:28Z","receivedAt":"2019-11-15T22:05:33Z","isPatch":true,"sender":{"key":"liu.denton@gmail.com","avatar":"https://avatars.githubusercontent.com/u/9620836?v=4"},"body":"Hi Emily,\n\nOn Fri, Nov 15, 2019 at 01:53:42PM -0800, Emily Shaffer wrote:\n> With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\n> now have a mentoring mailing list, to which we should direct new\n> contributors who have questions.\n> \n> Since #git-devel's traffic is fairly low, it should be OK to direct some\n> questions there too. Mention some of the conventions in case folks are\n> unfamiliar with IRC.\n> \n> Because the mentoring list and #git-devel are both a subset of Git\n> contributors, it's possible that no response is found on either forum,\n> so list the main mailing list as a fallback and mention some of the\n> conventions.\n> \n> Signed-off-by: Emily Shaffer \n> ---\n> Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++\n> 1 file changed, 32 insertions(+)\n> \n> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\n> index 5e9b808f5f..9fe197c98e 100644\n> --- a/Documentation/MyFirstContribution.txt\n> +++ b/Documentation/MyFirstContribution.txt\n> @@ -23,6 +23,38 @@ useful additional context:\n> - `Documentation/SubmittingPatches`\n> - `Documentation/howto/new-command.txt`\n> \n> +[[getting-help]]\n> +=== Getting Help\n> +\n> +If you get stuck, you can seek help in the following places.\n> +\n> +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n> +\n> +This mailing list is targeted to new contributors and is a great place to post\n> +questions and receive kind, detailed answers from volunteers on the Git\n> +project. You must join the group to view messages or post.\n> +\n> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n> +\n> +This IRC channel is for conversations between Git contributors. If someone is\n> +currently online and knows the answer to your question, you can receive help\n> +in real time. Otherwise, you can read the\n> +https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n> +whether someone answered you. IRC does not allow offline private messaging, so\n> +if you try to private message someone and then log out of IRC, they cannot\n> +respond to you. It's better to ask your questions in the channel so that you\n> +can be answered if you disconnect and so that others can learn from the\n> +conversation.\n> +\n> +==== https://public-inbox.org/git[git@vger.kernel.org]\n> +\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. If you fail to receive\n> +help via the channels above, you can ask your question here. You can join by\n> +sending an email to majordomo@vger.kernel.org with \"subscribe git\" in the body.\n> +The Git list requires plain-text-only emails and prefers inline and\n> +bottom-posting when replying to mail.\n\nPerhaps we could explicitly mention that subscribing to the list is\noptional and not required to post (especially since we CC everyone\nhere)? New contributors may be intimidated by the volume of mail going\nthrough here so knowing that they don't have to subscribe might be\nhelpful.\n\nThanks,\n\nDenton\n\n> +\n> [[getting-started]]\n> == Getting Started\n> \n> -- \n> 2.24.0.432.g9d3f5f5b63-goog\n> \n"},{"id":"386345","messageId":"20191115230346.GE22855@google.com","threadId":"52275","inReplyTo":"20191115220528.GA80935@generichostname","subject":"Re: [PATCH] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-11-15T23:03:46Z","receivedAt":"2019-11-15T23:03:53Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Fri, Nov 15, 2019 at 02:05:28PM -0800, Denton Liu wrote:\n> Hi Emily,\n> \n> On Fri, Nov 15, 2019 at 01:53:42PM -0800, Emily Shaffer wrote:\n> > +==== https://public-inbox.org/git[git@vger.kernel.org]\n> > +\n> > +This is the main Git project mailing list where code reviews, version\n> > +announcements, design discussions, and more take place. If you fail to receive\n> > +help via the channels above, you can ask your question here. You can join by\n> > +sending an email to majordomo@vger.kernel.org with \"subscribe git\" in the body.\n> > +The Git list requires plain-text-only emails and prefers inline and\n> > +bottom-posting when replying to mail.\n> \n> Perhaps we could explicitly mention that subscribing to the list is\n> optional and not required to post (especially since we CC everyone\n> here)? New contributors may be intimidated by the volume of mail going\n> through here so knowing that they don't have to subscribe might be\n> helpful.\n\nYeah, good idea. I'll move the plaintext/posting order rules sentence in\nfront of the majordomo sentence, and add \"optionally\" to the beginning\nof the majordomo sentence. Thanks.\n\n - Emily\n"},{"id":"386346","messageId":"20191115230637.76877-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"20191115215342.37408-1-emilyshaffer@google.com","subject":"[PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-11-15T23:06:37Z","receivedAt":"2019-11-15T23:06:46Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nSince #git-devel's traffic is fairly low, it should be OK to direct some\nquestions there too. Mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, it's possible that no response is found on either forum,\nso list the main mailing list as a fallback and mention some of the\nconventions.\n\nSigned-off-by: Emily Shaffer \n---\n\nReworded the Git mailing list blurb per Denton's recommendation.\n\n Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++\n 1 file changed, 33 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 5e9b808f5f..90f45b387a 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,39 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== https://public-inbox.org/git[git@vger.kernel.org]\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. If you fail to receive\n+help via the channels above, you can ask your question here. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.24.0.432.g9d3f5f5b63-goog\n\n"},{"id":"386349","messageId":"nycvar.QRO.7.76.6.1911160038170.46@tvgsbejvaqbjf.bet","threadId":"52275","inReplyTo":"20191115230637.76877-1-emilyshaffer@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2019-11-15T23:38:38Z","receivedAt":"2019-11-15T23:38:59Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi Emily,\n\nOn Fri, 15 Nov 2019, Emily Shaffer wrote:\n\n> With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\n> now have a mentoring mailing list, to which we should direct new\n> contributors who have questions.\n>\n> Since #git-devel's traffic is fairly low, it should be OK to direct some\n> questions there too. Mention some of the conventions in case folks are\n> unfamiliar with IRC.\n>\n> Because the mentoring list and #git-devel are both a subset of Git\n> contributors, it's possible that no response is found on either forum,\n> so list the main mailing list as a fallback and mention some of the\n> conventions.\n>\n> Signed-off-by: Emily Shaffer \n> ---\n\nLooks good to me.\n\nThanks!\nDscho\n\n>\n> Reworded the Git mailing list blurb per Denton's recommendation.\n>\n> Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++\n> 1 file changed, 33 insertions(+)\n>\n> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\n> index 5e9b808f5f..90f45b387a 100644\n> --- a/Documentation/MyFirstContribution.txt\n> +++ b/Documentation/MyFirstContribution.txt\n> @@ -23,6 +23,39 @@ useful additional context:\n> - `Documentation/SubmittingPatches`\n> - `Documentation/howto/new-command.txt`\n>\n> +[[getting-help]]\n> +=== Getting Help\n> +\n> +If you get stuck, you can seek help in the following places.\n> +\n> +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n> +\n> +This mailing list is targeted to new contributors and is a great place to post\n> +questions and receive kind, detailed answers from volunteers on the Git\n> +project. You must join the group to view messages or post.\n> +\n> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n> +\n> +This IRC channel is for conversations between Git contributors. If someone is\n> +currently online and knows the answer to your question, you can receive help\n> +in real time. Otherwise, you can read the\n> +https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n> +whether someone answered you. IRC does not allow offline private messaging, so\n> +if you try to private message someone and then log out of IRC, they cannot\n> +respond to you. It's better to ask your questions in the channel so that you\n> +can be answered if you disconnect and so that others can learn from the\n> +conversation.\n> +\n> +==== https://public-inbox.org/git[git@vger.kernel.org]\n> +\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. If you fail to receive\n> +help via the channels above, you can ask your question here. The Git list\n> +requires plain-text-only emails and prefers inline and bottom-posting when\n> +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> +\"subscribe git\" in the body.\n> +\n> [[getting-started]]\n> == Getting Started\n>\n> --\n> 2.24.0.432.g9d3f5f5b63-goog\n>\n>\n"},{"id":"386350","messageId":"20191116000947.GA30187@google.com","threadId":"52275","inReplyTo":"20191115230637.76877-1-emilyshaffer@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2019-11-16T00:09:47Z","receivedAt":"2019-11-16T00:09:53Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Emily Shaffer wrote:\n\n> --- a/Documentation/MyFirstContribution.txt\n> +++ b/Documentation/MyFirstContribution.txt\n> @@ -23,6 +23,39 @@ useful additional context:\n> - `Documentation/SubmittingPatches`\n> - `Documentation/howto/new-command.txt`\n> \n> +[[getting-help]]\n> +=== Getting Help\n> +\n> +If you get stuck, you can seek help in the following places.\n> +\n> +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n> +\n> +This mailing list is targeted to new contributors and is a great place to post\n> +questions and receive kind, detailed answers from volunteers on the Git\n> +project. You must join the group to view messages or post.\n> +\n> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n> +\n> +This IRC channel is for conversations between Git contributors. If someone is\n> +currently online and knows the answer to your question, you can receive help\n> +in real time. Otherwise, you can read the\n> +https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n\noptional: https://j.mp/gitdevlog also works and is briefer.\n\n> +whether someone answered you. IRC does not allow offline private messaging, so\n> +if you try to private message someone and then log out of IRC, they cannot\n> +respond to you. It's better to ask your questions in the channel so that you\n> +can be answered if you disconnect and so that others can learn from the\n> +conversation.\n> +\n> +==== https://public-inbox.org/git[git@vger.kernel.org]\n> +\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. If you fail to receive\n> +help via the channels above, you can ask your question here. The Git list\n> +requires plain-text-only emails and prefers inline and bottom-posting when\n> +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> +\"subscribe git\" in the body.\n> +\n\nVery nice.\n\nReviewed-by: Jonathan Nieder \n\nThanks.\n"},{"id":"386358","messageId":"xmqqv9rk4j1y.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20191115230637.76877-1-emilyshaffer@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-11-16T03:05:45Z","receivedAt":"2019-11-16T03:05:53Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> +[[getting-help]]\n> +=== Getting Help\n> +\n> +If you get stuck, you can seek help in the following places.\n\nIs this list meant to be an exhaustive list of authoritative\nsources? IOW, are we reasonably sure that some of us would be\naround and give useful help, and that we do not mind readers to\nconsider these places \"officially endorsed by the project\"?\n\nOr is this meant to be a list of reasonably well-known places, but\nmay include places where the project does not want to be associated\nwith the quality of answers given there? \n\nI am (implicitly) assuming that it is the former, but I think it is\nbetter to clarify what this \"list of places\" is meant to be.\n\nI notice that stack overflow is missing in this list. Intended?\nNot that I visit there at all nor I would recommend it, but I recall\nseeing questions asked by more than a few people after getting bad\npieces of advice there.\n\n> +==== https://public-inbox.org/git[git@vger.kernel.org]\n> +\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. If you fail to receive\n> +help via the channels above, you can ask your question here. The Git list\n> +requires plain-text-only emails and prefers inline and bottom-posting when\n> +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> +\"subscribe git\" in the body.\n\nSounds good; I agree with Denton, especially with the mention of\n\"you must join\" on the other mailing list, that it is a good idea to\nexplicitly say that subscription is optional in this entry.\n\nYou can ask questions even if you haven't tried other avenues and\nfailed, but this entry makes it sound as if an earlier failure\nelsewhere is a prerequisite for asking for help here.\n\n\nThanks.\n"},{"id":"386469","messageId":"20191118214519.GH22855@google.com","threadId":"52275","inReplyTo":"xmqqv9rk4j1y.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-11-18T21:45:19Z","receivedAt":"2019-11-18T21:45:29Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Sat, Nov 16, 2019 at 12:05:45PM +0900, Junio C Hamano wrote:\n> Emily Shaffer writes:\n> \n> > +[[getting-help]]\n> > +=== Getting Help\n> > +\n> > +If you get stuck, you can seek help in the following places.\n> \n> Is this list meant to be an exhaustive list of authoritative\n> sources?\n\nTo the best of my knowledge, as applicable, yeah.\n\n> IOW, are we reasonably sure that some of us would be\n> around and give useful help, and that we do not mind readers to\n> consider these places \"officially endorsed by the project\"?\n\nRight. That's my hope. I worry that sending newbies to non-endorsed\nplaces for help will lead to them getting incorrect or conflicting help.\n\n> \n> Or is this meant to be a list of reasonably well-known places, but\n> may include places where the project does not want to be associated\n> with the quality of answers given there? \n\nNo.\n\n> I am (implicitly) assuming that it is the former, but I think it is\n> better to clarify what this \"list of places\" is meant to be.\n\nI'll try to fudge the language so that it implies these are official\nchannels for getting help.\n\n> I notice that stack overflow is missing in this list. Intended?\n> Not that I visit there at all nor I would recommend it, but I recall\n> seeing questions asked by more than a few people after getting bad\n> pieces of advice there.\n\nHm. SO for getting help contributing to a specific project? That doesn't\nsound like a likely avenue or a good idea to me, since my understanding\nis that we don't consider it an \"official presence\" (some projects do, I\nguess).\n\nI suppose the kinds of questions I expect to see on StackOverflow\ninclude \"How do I write a mutex lock in C\" or \"How do I generate patches\nwith a cover letter\", not \"I'm stuck on this Git tutorial\" or \"Would the\nGit project welcome X change\". To me, this doesn't seem like the place\nto bring it up one way or another.\n\n> \n> > +==== https://public-inbox.org/git[git@vger.kernel.org]\n> > +\n> > +This is the main Git project mailing list where code reviews, version\n> > +announcements, design discussions, and more take place. If you fail to receive\n> > +help via the channels above, you can ask your question here. The Git list\n> > +requires plain-text-only emails and prefers inline and bottom-posting when\n> > +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> > +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> > +\"subscribe git\" in the body.\n> \n> Sounds good; I agree with Denton, especially with the mention of\n> \"you must join\" on the other mailing list, that it is a good idea to\n> explicitly say that subscription is optional in this entry.\n> \n> You can ask questions even if you haven't tried other avenues and\n> failed, but this entry makes it sound as if an earlier failure\n> elsewhere is a prerequisite for asking for help here.\n\nI envision an exchange sort of like this:\n\nNewbie to git@vger.kernel.org: \"I'm having trouble compiling Git and I\nwant to write a patch, I'm getting X error\"\n\nVeteran to Newbie, cc git-mentoring, bcc git@vger.kernel.org:\n\"Please build with blah flag and paste console output, plus let us know\nsystem information blah blah blah\"\n\nI don't mind the idea of pushing folks to ask on the mentoring list\nfirst. It's pretty well attended already - just now I count 16 list\nmembers, a pretty significant majority of which are project veterans. I\nhave no problem suggesting newbies ask their questions, which others\nprobably had and solved before them, in a space separate from the main\nmailing list.\n\nOf course if you want to encourage newbies to ask in any of these three\nvenues, weighted equally, I can change the language. But suggesting the\nmain list as a last resort was intentional.\n\n - Emily\n"},{"id":"386496","messageId":"xmqqy2wczliu.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20191118214519.GH22855@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-11-19T01:45:45Z","receivedAt":"2019-11-19T01:45:52Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n>> I am (implicitly) assuming that it is the former, but I think it is\n>> better to clarify what this \"list of places\" is meant to be.\n>\n> I'll try to fudge the language so that it implies these are official\n> channels for getting help.\n\nSounds good.\n\n>> I notice that stack overflow is missing in this list. Intended?\n>> Not that I visit there at all nor I would recommend it, but I recall\n>> seeing questions asked by more than a few people after getting bad\n>> pieces of advice there.\n>\n> Hm. SO for getting help contributing to a specific project? ...\n> I suppose the kinds of questions I expect to see on StackOverflow\n> include \"How do I write a mutex lock in C\" or \"How do I generate patches\n> with a cover letter\", not \"I'm stuck on this Git tutorial\" or \"Would the\n> Git project welcome X change\". To me, this doesn't seem like the place\n> to bring it up one way or another.\n\nI am glad I brought this up, because \"How do I force git ignore\nchanges I make to an already tracked file?\" was a question I thought\na reader of this document might want to ask to these \"avenues for\ngetting help\", and I wouldn't be surprised to see such a question\nasked on stack overflow.\n\nAfter re-reading the title of the document, I am reminded that the\nintended audience is aspiring Git developers, and I now know that it\nis silly for an aspiring Git _developer_ to be asking such a\nquestion---I am guessing you meant that these \"avenues\" are only\nabout getting help on _developing_ code to be included in git-core,\nand in that context, yes, I agree that SO is a poor place for that.\n\nI'll re-read the patch to see if what is written in the document is\nprone to this kind of misunderstanding, or it was just my fault to\nhave failed to notice a clear description on what kind of help the\nsection is talking about.\n\n> I envision an exchange sort of like this:\n>\n> Newbie to git@vger.kernel.org: \"I'm having trouble compiling Git and I\n> want to write a patch, I'm getting X error\"\n>\n> Veteran to Newbie, cc git-mentoring, bcc git@vger.kernel.org:\n> \"Please build with blah flag and paste console output, plus let us know\n> system information blah blah blah\"\n>\n> I don't mind the idea of pushing folks to ask on the mentoring list\n> first. It's pretty well attended already - just now I count 16 list\n> members, a pretty significant majority of which are project veterans. I\n> have no problem suggesting newbies ask their questions, which others\n> probably had and solved before them, in a space separate from the main\n> mailing list.\n\nOK. I understand and agree with the direction.\n\nI wonder how well the \"CC: git-mentoring\" part would work, though.\n\nA response to \"plus let us know\" by the Newbie will most likely keep\nthe list on CC, which would bounce with \"you must be subscribed\"?\nIt may appear rather rude to tell somebody they need to subscribe to\nanother list in order to obtain the help.\n\nThanks.\n"},{"id":"386543","messageId":"20191119182501.GA5076@szeder.dev","threadId":"52275","inReplyTo":"20191115230637.76877-1-emilyshaffer@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2019-11-19T18:25:01Z","receivedAt":"2019-11-19T18:25:10Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Fri, Nov 15, 2019 at 03:06:37PM -0800, Emily Shaffer wrote:\n> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n> +\n> +This IRC channel is for conversations between Git contributors. If someone is\n> +currently online and knows the answer to your question, you can receive help\n> +in real time. Otherwise, you can read the\n> +https://colabti.org/irclogger//irclogger_logs/git-devel[scrollback] to see\n\nNit: there are two consecutive slashes in the middle of that URL.\n\n"},{"id":"386544","messageId":"20191119184919.GM23183@szeder.dev","threadId":"52275","inReplyTo":"20191118214519.GH22855@google.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2019-11-19T18:49:19Z","receivedAt":"2019-11-19T18:49:25Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Mon, Nov 18, 2019 at 01:45:19PM -0800, Emily Shaffer wrote:\n> On Sat, Nov 16, 2019 at 12:05:45PM +0900, Junio C Hamano wrote:\n> > > +==== https://public-inbox.org/git[git@vger.kernel.org]\n> > > +\n> > > +This is the main Git project mailing list where code reviews, version\n> > > +announcements, design discussions, and more take place. If you fail to receive\n> > > +help via the channels above, you can ask your question here. The Git list\n> > > +requires plain-text-only emails and prefers inline and bottom-posting when\n> > > +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> > > +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> > > +\"subscribe git\" in the body.\n> > \n> > Sounds good; I agree with Denton, especially with the mention of\n> > \"you must join\" on the other mailing list, that it is a good idea to\n> > explicitly say that subscription is optional in this entry.\n> > \n> > You can ask questions even if you haven't tried other avenues and\n> > failed, but this entry makes it sound as if an earlier failure\n> > elsewhere is a prerequisite for asking for help here.\n> \n> I envision an exchange sort of like this:\n> \n> Newbie to git@vger.kernel.org: \"I'm having trouble compiling Git and I\n> want to write a patch, I'm getting X error\"\n> \n> Veteran to Newbie, cc git-mentoring, bcc git@vger.kernel.org:\n> \"Please build with blah flag and paste console output, plus let us know\n> system information blah blah blah\"\n\nThat won't work if the veteran is not registered to the mentoring\nlist, and we can't assume that the newbie is registered there either.\nI don't think that we should send anyone who asked a question here to\nsomewhere else, especially if that elsewhere requires registration.\n\n> I don't mind the idea of pushing folks to ask on the mentoring list\n> first. It's pretty well attended already - just now I count 16 list\n> members, a pretty significant majority of which are project veterans. I\n> have no problem suggesting newbies ask their questions, which others\n> probably had and solved before them, in a space separate from the main\n> mailing list.\n> \n> Of course if you want to encourage newbies to ask in any of these three\n> venues, weighted equally, I can change the language. But suggesting the\n> main list as a last resort was intentional.\n\ngit@vger is the ultimate source of all wisdom :) and it is openly\naccessible for anyone for writing, reading, and searching. Therefore\nthese three venues cannot be weighted equally, but git@vger should be\nthe explicitly preferred venue. Only if the newbie has some other\npreferences should the other two be considered; e.g. if more\ninteractive, chatty communication is preferred, then try #git-devel.\n\n"},{"id":"386555","messageId":"nycvar.QRO.7.76.6.1911192227280.15956@tvgsbejvaqbjf.bet","threadId":"52275","inReplyTo":"20191119184919.GM23183@szeder.dev","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2019-11-19T21:29:43Z","receivedAt":"2019-11-19T21:30:08Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi Gábor,\n\nOn Tue, 19 Nov 2019, SZEDER Gábor wrote:\n\n> On Mon, Nov 18, 2019 at 01:45:19PM -0800, Emily Shaffer wrote:\n>\n> > I don't mind the idea of pushing folks to ask on the mentoring list\n> > first. It's pretty well attended already - just now I count 16 list\n> > members, a pretty significant majority of which are project veterans.\n> > I have no problem suggesting newbies ask their questions, which others\n> > probably had and solved before them, in a space separate from the main\n> > mailing list.\n> >\n> > Of course if you want to encourage newbies to ask in any of these\n> > three venues, weighted equally, I can change the language. But\n> > suggesting the main list as a last resort was intentional.\n>\n> git@vger is the ultimate source of all wisdom :) and it is openly\n> accessible for anyone for writing,\n\n... except people with an @outlook.com address (all of their emails will\nbounce) and people who do not know how to suppress HTML in their emails\n(which I believe constitutes the vast majority)...\n\n> reading, and searching. Therefore these three venues cannot be weighted\n> equally, but git@vger should be the explicitly preferred venue. Only if\n> the newbie has some other preferences should the other two be\n> considered; e.g. if more interactive, chatty communication is preferred,\n> then try #git-devel.\n\nCiao,\nDscho\n"},{"id":"386556","messageId":"20191119214101.GN23183@szeder.dev","threadId":"52275","inReplyTo":"nycvar.QRO.7.76.6.1911192227280.15956@tvgsbejvaqbjf.bet","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2019-11-19T21:41:01Z","receivedAt":"2019-11-19T21:41:13Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Tue, Nov 19, 2019 at 10:29:43PM +0100, Johannes Schindelin wrote:\n> Hi Gábor,\n> \n> On Tue, 19 Nov 2019, SZEDER Gábor wrote:\n> \n> > On Mon, Nov 18, 2019 at 01:45:19PM -0800, Emily Shaffer wrote:\n> >\n> > > I don't mind the idea of pushing folks to ask on the mentoring list\n> > > first. It's pretty well attended already - just now I count 16 list\n> > > members, a pretty significant majority of which are project veterans.\n> > > I have no problem suggesting newbies ask their questions, which others\n> > > probably had and solved before them, in a space separate from the main\n> > > mailing list.\n> > >\n> > > Of course if you want to encourage newbies to ask in any of these\n> > > three venues, weighted equally, I can change the language. But\n> > > suggesting the main list as a last resort was intentional.\n> >\n> > git@vger is the ultimate source of all wisdom :) and it is openly\n> > accessible for anyone for writing,\n> \n> ... except people with an @outlook.com address (all of their emails will\n> bounce) and people who do not know how to suppress HTML in their emails\n> (which I believe constitutes the vast majority)...\n\nAnd I believe that that \"vast majority\" will never try to contribute\nto Git, and thus doesn't matter.\n\n> > reading, and searching. Therefore these three venues cannot be weighted\n> > equally, but git@vger should be the explicitly preferred venue. Only if\n> > the newbie has some other preferences should the other two be\n> > considered; e.g. if more interactive, chatty communication is preferred,\n> > then try #git-devel.\n"},{"id":"386598","messageId":"20191120015008.GB2864@dcvr","threadId":"52275","inReplyTo":"20191119214101.GN23183@szeder.dev","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Eric Wong","fromEmail":"e@80x24.org","sentAt":"2019-11-20T01:50:08Z","receivedAt":"2019-11-20T01:50:10Z","isPatch":true,"sender":{"key":"e@80x24.org","avatar":null},"body":"SZEDER Gábor wrote:\n> On Tue, Nov 19, 2019 at 10:29:43PM +0100, Johannes Schindelin wrote:\n> > On Tue, 19 Nov 2019, SZEDER Gábor wrote:\n> > > git@vger is the ultimate source of all wisdom :) and it is openly\n> > > accessible for anyone for writing,\n> > \n> > ... except people with an @outlook.com address (all of their emails will\n> > bounce) and people who do not know how to suppress HTML in their emails\n> > (which I believe constitutes the vast majority)...\n> \n> And I believe that that \"vast majority\" will never try to contribute\n> to Git, and thus doesn't matter.\n\nNo. A better objective would be to promote plain-text to the\npoint where the \"vast majority\" expect it. Ironically, major\nsocial networks and forums are already that way. HTML mail can\nbecome solely an avenue for phishers and spammers, and\neventually eradicated. It'll be a long battle ahead, though...\n"},{"id":"386629","messageId":"AM0PR02MB3715245F0CB1C7678DA8794F9C4F0@AM0PR02MB3715.eurprd02.prod.outlook.com","threadId":"52275","inReplyTo":"nycvar.QRO.7.76.6.1911192227280.15956@tvgsbejvaqbjf.bet","subject":"RE: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Kerry, Richard","fromEmail":"richard.kerry@atos.net","sentAt":"2019-11-20T10:45:44Z","receivedAt":"2019-11-20T10:45:55Z","isPatch":true,"sender":{"key":"richard.kerry@atos.net","avatar":null},"body":"> From: git-owner@vger.kernel.org On Behalf\n> Of Johannes Schindelin\n> Sent: Tuesday, November 19, 2019 9:30 PM\n> To: SZEDER Gábor \n> ... except people with an @outlook.com address (all of their emails will\n> bounce) and people who do not know how to suppress HTML in their emails\n> (which I believe constitutes the vast majority)...\n\n[RK>] And even those of us who can find the plain/html format selection control may find that our employer's system turns everything into base64 anyway, thus again making it impossible to post to vger. I fully expect this email to reach all those of you who are To or CC, but not to reach vger.\n\nRegards,\nRichard.\n"},{"id":"386633","messageId":"xmqqk17ubwy9.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"AM0PR02MB3715245F0CB1C7678DA8794F9C4F0@AM0PR02MB3715.eurprd02.prod.outlook.com","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-11-20T11:37:18Z","receivedAt":"2019-11-20T11:37:23Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"\"Kerry, Richard\" writes:\n\n>> From: git-owner@vger.kernel.org On Behalf\n>> Of Johannes Schindelin\n>> Sent: Tuesday, November 19, 2019 9:30 PM\n>> To: SZEDER Gábor \n>> ... except people with an @outlook.com address (all of their emails will\n>> bounce) and people who do not know how to suppress HTML in their emails\n>> (which I believe constitutes the vast majority)...\n>\n> [RK>] And even those of us who can find the plain/html format\n> selection control may find that our employer's system turns\n> everything into base64 anyway, thus again making it impossible to\n> post to vger. I fully expect this email to reach all those of you\n> who are To or CC, but not to reach vger.\n\nYou actually can read it on public-inbox.org/git/ which means vger\ncorrectly forwarded ;-)\n"},{"id":"386634","messageId":"nycvar.QRO.7.76.6.1911201222490.15956@tvgsbejvaqbjf.bet","threadId":"52275","inReplyTo":"20191119214101.GN23183@szeder.dev","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2019-11-20T11:41:56Z","receivedAt":"2019-11-20T11:42:21Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi Gábor,\n\nOn Tue, 19 Nov 2019, SZEDER Gábor wrote:\n\n> On Tue, Nov 19, 2019 at 10:29:43PM +0100, Johannes Schindelin wrote:\n> >\n> > On Tue, 19 Nov 2019, SZEDER Gábor wrote:\n> >\n> > > On Mon, Nov 18, 2019 at 01:45:19PM -0800, Emily Shaffer wrote:\n> > >\n> > > > I don't mind the idea of pushing folks to ask on the mentoring list\n> > > > first. It's pretty well attended already - just now I count 16 list\n> > > > members, a pretty significant majority of which are project veterans.\n> > > > I have no problem suggesting newbies ask their questions, which others\n> > > > probably had and solved before them, in a space separate from the main\n> > > > mailing list.\n> > > >\n> > > > Of course if you want to encourage newbies to ask in any of these\n> > > > three venues, weighted equally, I can change the language. But\n> > > > suggesting the main list as a last resort was intentional.\n> > >\n> > > git@vger is the ultimate source of all wisdom :) and it is openly\n> > > accessible for anyone for writing,\n> >\n> > ... except people with an @outlook.com address (all of their emails will\n> > bounce) and people who do not know how to suppress HTML in their emails\n> > (which I believe constitutes the vast majority)...\n>\n> And I believe that that \"vast majority\" will never try to contribute\n> to Git, and thus doesn't matter.\n\nYes, this is a tautology, because by that very expectation you make that\nhappen. It's kind of a perfect example of a self-fulfilling prophecy.\n\nAnd while I write this, I realize that my answer is not even data-driven.\nSo *clicketyclick*:\n\n$ git shortlog -nse | grep outlook\n 6 Force Charlie \n 1 Rohit Mani \n\nOh wait, what? That vast majority will never contribute? Not so \"never\",\nafter all. Well, it is certain that they do not feel invited to the Git\nmailing list, that much is clear. Force Charlie's contributions probably\nall came in via Git for Windows (because it does not slam the door in the\nface of Outlook.com users, is my guess).\n\nBut Rohit is an interesting case. Apparently in 2014, vger had no qualms\nabout letting @outlook.com users in:\n\nhttps://public-inbox.org/git/BLU0-SMTP956BEABA437FB370F76953918A0@phx.gbl/\n\nWell, I guess as long as we can make a nice and cozy place for ourselves\nand our kind here, and contend ourselves with the knowledge that the rest\nof them out there don't matter, all is fine and dandy.\n\nOr maybe it is not. Maybe this is not fine and dandy at all.\n\nMaybe I find this very much _not_ in line with the decency that I normally\nsee on this here Git mailing list, in particular with the later arrivals.\nWith the politeness and respect for other people and their different\ntastes (such as the taste for HTML-formatted mails, which _do_ make\nconveying certain things a lot easier) that I hoped we could all agree on,\nand which I actually did feel during our Virtual Contributor Summit\nearlier this fall.\n\nI don't know about you, but if I were to read on any mailing list that I\ndo not matter at all, I would have a range of totally understandable\nfeelings about that.\n\nIn short: This is not what I want to see on this list, it is not in line\nwith my understanding of being respectful to one another.\n\nLet's hold ourselves to a higher standard, okay?\n\nCiao,\nDscho\n\n> > > reading, and searching. Therefore these three venues cannot be weighted\n> > > equally, but git@vger should be the explicitly preferred venue. Only if\n> > > the newbie has some other preferences should the other two be\n> > > considered; e.g. if more interactive, chatty communication is preferred,\n> > > then try #git-devel.\n>\n\nP.S.: I _think_ that I understand where exclusive behavior comes from, of\ncourse, there is ample research about this, see e.g.\nhttps://en.wikipedia.org/wiki/In-group_and_out-group. This explains it,\nbut does not excuse it.\n"},{"id":"386666","messageId":"20191120234027.GP23183@szeder.dev","threadId":"52275","inReplyTo":"nycvar.QRO.7.76.6.1911201222490.15956@tvgsbejvaqbjf.bet","subject":"Re: [PATCH v2] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2019-11-20T23:40:27Z","receivedAt":"2019-11-20T23:40:35Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Wed, Nov 20, 2019 at 12:41:56PM +0100, Johannes Schindelin wrote:\n> Hi Gábor,\n> \n> On Tue, 19 Nov 2019, SZEDER Gábor wrote:\n> \n> > On Tue, Nov 19, 2019 at 10:29:43PM +0100, Johannes Schindelin wrote:\n> > >\n> > > On Tue, 19 Nov 2019, SZEDER Gábor wrote:\n> > >\n> > > > On Mon, Nov 18, 2019 at 01:45:19PM -0800, Emily Shaffer wrote:\n> > > >\n> > > > > I don't mind the idea of pushing folks to ask on the mentoring list\n> > > > > first. It's pretty well attended already - just now I count 16 list\n> > > > > members, a pretty significant majority of which are project veterans.\n> > > > > I have no problem suggesting newbies ask their questions, which others\n> > > > > probably had and solved before them, in a space separate from the main\n> > > > > mailing list.\n> > > > >\n> > > > > Of course if you want to encourage newbies to ask in any of these\n> > > > > three venues, weighted equally, I can change the language. But\n> > > > > suggesting the main list as a last resort was intentional.\n> > > >\n> > > > git@vger is the ultimate source of all wisdom :) and it is openly\n> > > > accessible for anyone for writing,\n> > >\n> > > ... except people with an @outlook.com address (all of their emails will\n> > > bounce) and people who do not know how to suppress HTML in their emails\n> > > (which I believe constitutes the vast majority)...\n\nMy interpretation of the above paragraph was that the \"(which I\nbelieve constitutes the vast majority)\" part refers only to the\n\"people who do not know how to suppress HTML in their emails\", but not\nto the aforementioned \"people with an @outlook.com address\" (who had\ntheir own subsentence in parentheses).\n\nAnd with that statement in itself I completely agree: I would expect\nthat that \"vast majority\", i.e. the number of people who don't know\nhow to suppress HTML in their emails is in the billions, though I have\nno data on that.\n\n> > And I believe that that \"vast majority\" will never try to contribute\n> > to Git, and thus doesn't matter.\n\nI could have worded this more carefully, e.g. along the lines of:\n\n I believe that the vast majority of people will never contribute to\n Git anyway, therefore trying to give more weight to your argument\n with that \"vast majority\" doesn't make it any stronger.\n\n> Yes, this is a tautology, because by that very expectation you make that\n> happen. It's kind of a perfect example of a self-fulfilling prophecy.\n\nCall it as you wish, I think it's simply inconceivable that the vast\nmajority of people will contribute to Git.\n\n\n[Snipping the parts that appear to stem from the misunderstanding that\nI tried to clarify above, in the hope that we can focus on the more\nimportant point, which is:]\n\n\n> > > > reading, and searching.\n\nI would like to emphasize these last words of the sentence that was\ncut in two so unfortunately, because I'm afraid that they didn't get\nthe attention they deserve although they are of fundamental\nimportance.\n\nIf someone reaches out to us with a problem, and we can provide a\nsolution, then it's best to have that solution openly accessible for\nthe benefit of everyone else. IMO this far outweighs any issues with\nHTML-formatted emails or @outlook.com email addresses, and on its own\njustifies putting git@vger first. That way even those who stop\nreading at the first email address will choose what's most beneficial\nfor the greater good. If someone for some reason still prefers\notherwise and/or due to some technical limitation can't post to\ngit@vger, then they could still consider the other two venues.\n\n> > > > Therefore these three venues cannot be weighted\n> > > > equally, but git@vger should be the explicitly preferred venue. Only if\n> > > > the newbie has some other preferences should the other two be\n> > > > considered; e.g. if more interactive, chatty communication is preferred,\n> > > > then try #git-devel.\n"},{"id":"388070","messageId":"20191213013128.6268-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"20191115230637.76877-1-emilyshaffer@google.com","subject":"[PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-12-13T01:31:28Z","receivedAt":"2019-12-13T01:31:36Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nSince #git-devel's traffic is fairly low, it should be OK to direct some\nquestions there too. Mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, finally list the main Git list and mention some of the\nposting conventions.\n\nSigned-off-by: Emily Shaffer \n---\nSince v2:\n\n- Removed a double slash in a URL\n- public-inbox -> lore.kernel.org\n- Removed indication that Git list should be a fallback; instead, treat\n it as equally useful for first attempt at Q&A.\n\nAs for the conversation which spun off regarding the access controls on\ngit-mentoring list, since the list still hasn't seen traffic, I'm going\nto keep them as they are for a little longer.\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++\n 1 file changed, 32 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 35b9130aa3..e7489d156a 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,38 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== https://lore.kernel.org/git[git@vger.kernel.org]\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.24.1.735.g03f4e72817-goog\n\n"},{"id":"388073","messageId":"f3037862-b8f7-d674-4b1e-7b9df3fa49cd@gmail.com","threadId":"52275","inReplyTo":"20191213013128.6268-1-emilyshaffer@google.com","subject":"Re: [PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Derrick Stolee","fromEmail":"stolee@gmail.com","sentAt":"2019-12-13T03:00:45Z","receivedAt":"2019-12-13T03:00:50Z","isPatch":true,"sender":{"key":"stolee@gmail.com","avatar":"https://avatars.githubusercontent.com/u/570044?v=4"},"body":"On 12/12/2019 8:31 PM, Emily Shaffer wrote:\n> With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\n\nWe are trying to move to lore.kernel.org, I think.\n\n> now have a mentoring mailing list, to which we should direct new\n> contributors who have questions.\n> \n> Since #git-devel's traffic is fairly low, it should be OK to direct some\n> questions there too. Mention some of the conventions in case folks are\n> unfamiliar with IRC.\n> \n> Because the mentoring list and #git-devel are both a subset of Git\n> contributors, finally list the main Git list and mention some of the\n> posting conventions.\n> \n> Signed-off-by: Emily Shaffer \n> ---\n> Since v2:\n> \n> - Removed a double slash in a URL\n> - public-inbox -> lore.kernel.org\n\nAh, I see you mentioned it here and in the contents. Commit messages\nare harder to keep straight, in my experience.\n\n> +==== https://lore.kernel.org/git[git@vger.kernel.org]\n"},{"id":"388077","messageId":"20191213041429.GC135450@google.com","threadId":"52275","inReplyTo":"f3037862-b8f7-d674-4b1e-7b9df3fa49cd@gmail.com","subject":"Re: [PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-12-13T04:14:29Z","receivedAt":"2019-12-13T04:14:37Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Thu, Dec 12, 2019 at 10:00:45PM -0500, Derrick Stolee wrote:\n> On 12/12/2019 8:31 PM, Emily Shaffer wrote:\n> > With https://public-inbox.org/git/20191114194708.GD60198@google.com/ we\n> \n> We are trying to move to lore.kernel.org, I think.\n\nArgh, and I even wordsmithed a few paragraphs down in this commit\nmessage too. Sending..\n\n> \n> > now have a mentoring mailing list, to which we should direct new\n> > contributors who have questions.\n> > \n> > Since #git-devel's traffic is fairly low, it should be OK to direct some\n> > questions there too. Mention some of the conventions in case folks are\n> > unfamiliar with IRC.\n> > \n> > Because the mentoring list and #git-devel are both a subset of Git\n> > contributors, finally list the main Git list and mention some of the\n> > posting conventions.\n> > \n> > Signed-off-by: Emily Shaffer \n> > ---\n> > Since v2:\n> > \n> > - Removed a double slash in a URL\n> > - public-inbox -> lore.kernel.org\n> \n> Ah, I see you mentioned it here and in the contents. Commit messages\n> are harder to keep straight, in my experience.\n> \n> > +==== https://lore.kernel.org/git[git@vger.kernel.org]\n"},{"id":"388078","messageId":"20191213041656.24267-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"f3037862-b8f7-d674-4b1e-7b9df3fa49cd@gmail.com","subject":"[PATCH v4] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-12-13T04:16:56Z","receivedAt":"2019-12-13T04:17:30Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nSince #git-devel's traffic is fairly low, it should be OK to direct some\nquestions there too. Mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, finally list the main Git list and mention some of the\nposting conventions.\n\nSigned-off-by: Emily Shaffer \n---\n\nOnly difference from v3 is the public-inbox -> lore.kernel in the commit\nmessage. Thanks, Stolee.\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++\n 1 file changed, 32 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 35b9130aa3..e7489d156a 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,38 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== https://lore.kernel.org/git[git@vger.kernel.org]\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.24.1.735.g03f4e72817-goog\n\n"},{"id":"388123","messageId":"xmqq36dom9bf.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20191213013128.6268-1-emilyshaffer@google.com","subject":"Re: [PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-12-13T17:20:20Z","receivedAt":"2019-12-13T20:39:46Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> Since #git-devel's traffic is fairly low, it should be OK to direct some\n> questions there too.\n\nCorrect me if I recall wrong, but wasn't #git the original IRC\nchannel we developers hang out on, and then somebody thought \"the\ntraffic is fairly low, so it should be OK\" and directed non\ndeveloper trafic there, which caused the developers to migrate out\nto #git-devel, a new channel?\n"},{"id":"388132","messageId":"20191213174915.GD135450@google.com","threadId":"52275","inReplyTo":"xmqq36dom9bf.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-12-13T17:49:15Z","receivedAt":"2019-12-13T20:39:57Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Fri, Dec 13, 2019 at 09:20:20AM -0800, Junio C Hamano wrote:\n> Emily Shaffer writes:\n> \n> > Since #git-devel's traffic is fairly low, it should be OK to direct some\n> > questions there too.\n> \n> Correct me if I recall wrong, but wasn't #git the original IRC\n> channel we developers hang out on, and then somebody thought \"the\n> traffic is fairly low, so it should be OK\" and directed non\n> developer trafic there, which caused the developers to migrate out\n> to #git-devel, a new channel?\n\nI certainly don't have the background to correct you, as that was before\nmy time, but I can say that this document isn't directing non-developer\ntraffic. This is a tutorial for aspiring Git developers to ask questions\nabout Git development.\n\n - Emily\n"},{"id":"388140","messageId":"xmqqlfrgkr1g.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20191213174915.GD135450@google.com","subject":"Re: [PATCH v3] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-12-13T18:40:27Z","receivedAt":"2019-12-13T20:40:39Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> On Fri, Dec 13, 2019 at 09:20:20AM -0800, Junio C Hamano wrote:\n>> Emily Shaffer writes:\n>> \n>> > Since #git-devel's traffic is fairly low, it should be OK to direct some\n>> > questions there too.\n>> \n>> Correct me if I recall wrong, but wasn't #git the original IRC\n>> channel we developers hang out on, and then somebody thought \"the\n>> traffic is fairly low, so it should be OK\" and directed non\n>> developer trafic there, which caused the developers to migrate out\n>> to #git-devel, a new channel?\n>\n> I certainly don't have the background to correct you, as that was before\n> my time, but I can say that this document isn't directing non-developer\n> traffic. This is a tutorial for aspiring Git developers to ask questions\n> about Git development.\n\nI do not necessarily think it is a bad idea, but the rationale must\nbe \"#git-devel is for those who work on git, so it is very on topic\nthere\", not \"it is low traffic so anything can be sent there\".\n"},{"id":"390386","messageId":"20200124200915.249473-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"20191213013128.6268-1-emilyshaffer@google.com","subject":"[PATCH v5] MyFirstContribution: add avenues for getting help","fromName":"","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T20:09:16Z","receivedAt":"2020-01-24T20:10:24Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"From: Emily Shaffer \n\nWith https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nMention #git-devel, which is targeted for Git contributors; asking for\nhelp with getting a first contribution together is on-topic for that\nchannel. Also mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, finally list the main Git list and mention some of the\nposting conventions.\n\nSigned-off-by: Emily Shaffer \n---\nOn v3, Junio mentioned changing the justification for suggesting\n#git-devel in the commit-message. Stolee mentioned a missed reference to\npublic-inbox.org which was fixed in v4, but I mangled the threading, so\nI'll also move this one to reply to v3 instead of the\nin-thread-with-Stolee v4.\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 32 +++++++++++++++++++++++++++\n 1 file changed, 32 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 35b9130aa3..e7489d156a 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,38 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== https://lore.kernel.org/git[git@vger.kernel.org]\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.25.0.341.g760bfbb309-goog\n\n"},{"id":"390390","messageId":"xmqq7e1gzj73.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200124200915.249473-1-emilyshaffer@google.com","subject":"Re: [PATCH v5] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-01-24T20:35:28Z","receivedAt":"2020-01-24T20:36:51Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"emilyshaffer@google.com writes:\n\n> From: Emily Shaffer \n\nHmm, unlike folks who use GGG, your From: address seem almost usable\nwithout having to waste two extra lines (which matters when one has\nto review many patches a day).\n\n> With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\n> now have a mentoring mailing list, to which we should direct new\n> contributors who have questions.\n\nYay.\n\n> Mention #git-devel, which is targeted for Git contributors; asking for\n> help with getting a first contribution together is on-topic for that\n> channel. Also mention some of the conventions in case folks are\n> unfamiliar with IRC.\n>\n> Because the mentoring list and #git-devel are both a subset of Git\n> contributors, finally list the main Git list and mention some of the\n> posting conventions.\n\n> +[[getting-help]]\n> +=== Getting Help\n> +\n> +If you get stuck, you can seek help in the following places.\n> +\n> +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n> +\n> +This mailing list is targeted to new contributors and is a great place to post\n> +questions and receive kind, detailed answers from volunteers on the Git\n> +project. You must join the group to view messages or post.\n\nOK.\n\n\n> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n> +\n> +This IRC channel is for conversations between Git contributors. If someone is\n> +currently online and knows the answer to your question, you can receive help\n> +in real time. Otherwise, you can read the\n> +https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n> +whether someone answered you. IRC does not allow offline private messaging, so\n> +if you try to private message someone and then log out of IRC, they cannot\n> +respond to you. It's better to ask your questions in the channel so that you\n> +can be answered if you disconnect and so that others can learn from the\n> +conversation.\n\nOK.\n\n> +==== https://lore.kernel.org/git[git@vger.kernel.org]\n\nHmph. I would have expected mailto:git@vger.kernel.org as the main\nURL here, as this enumeration is not for those who lurk to passibly\nreceive information, but for those (new) contributors who want to\nask help by actively transmitting. Mentioning lore as an archive\nwhen talking about the list is necessary, but it shouldn't obscure\nthe main e-mail address people need to know in order to send their\nrequests.\n\n> +\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. The Git list\n> +requires plain-text-only emails and prefers inline and bottom-posting when\n> +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> +\"subscribe git\" in the body.\n\nThanks.\n"},{"id":"390392","messageId":"20200124205025.GA140846@google.com","threadId":"52275","inReplyTo":"xmqq7e1gzj73.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v5] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T20:50:25Z","receivedAt":"2020-01-24T20:50:33Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Fri, Jan 24, 2020 at 12:35:28PM -0800, Junio C Hamano wrote:\n> emilyshaffer@google.com writes:\n> \n> > From: Emily Shaffer \n> \n> Hmm, unlike folks who use GGG, your From: address seem almost usable\n> without having to waste two extra lines (which matters when one has\n> to review many patches a day).\n\nBlame an unhealthy appreciation for being able to write emails in Vim.\n\nI generate patches with 'git format-patch' - what's the unusable part of\n\"almost\" usable here? Typically I invoke it like so:\n\n git format-patch -o ~/mailed-patches/blah -vN master..branchname\n git send-email --to=git@vger.kernel.org ~/mailed-patches/blah/vN*\n\nIf there's more tweaking I should do in the workflow I'd like to know.\n\n> > +==== https://lore.kernel.org/git[git@vger.kernel.org]\n> \n> Hmph. I would have expected mailto:git@vger.kernel.org as the main\n> URL here, as this enumeration is not for those who lurk to passibly\n> receive information, but for those (new) contributors who want to\n> ask help by actively transmitting. Mentioning lore as an archive\n> when talking about the list is necessary, but it shouldn't obscure\n> the main e-mail address people need to know in order to send their\n> requests.\n\nOk. My personal bias as a long-time browser-as-primary-mail-client user\nleaked through. I'll send another revision now.\n"},{"id":"390393","messageId":"20200124205449.GB140846@google.com","threadId":"52275","inReplyTo":"20200124205025.GA140846@google.com","subject":"Re: [PATCH v5] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T20:54:49Z","receivedAt":"2020-01-24T20:54:57Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Fri, Jan 24, 2020 at 12:50:25PM -0800, Emily Shaffer wrote:\n> On Fri, Jan 24, 2020 at 12:35:28PM -0800, Junio C Hamano wrote:\n> > emilyshaffer@google.com writes:\n> > \n> > > From: Emily Shaffer \n> > \n> > Hmm, unlike folks who use GGG, your From: address seem almost usable\n> > without having to waste two extra lines (which matters when one has\n> > to review many patches a day).\n> \n> Blame an unhealthy appreciation for being able to write emails in Vim.\n> \n> I generate patches with 'git format-patch' - what's the unusable part of\n> \"almost\" usable here? Typically I invoke it like so:\n> \n> git format-patch -o ~/mailed-patches/blah -vN master..branchname\n> git send-email --to=git@vger.kernel.org ~/mailed-patches/blah/vN*\n> \n> If there's more tweaking I should do in the workflow I'd like to know.\n\nAh, I think that 'git send-email' is injecting this because I added a\nredundant \"sendemail.from\" line to my ~/.gitconfig while I was testing\nout 'git bugreport' for my other patchset. I'll remove that config from\nhere on.\n\n - Emily\n"},{"id":"390395","messageId":"20200124210148.220007-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"20200124200915.249473-1-emilyshaffer@google.com","subject":"[PATCH v6] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T21:01:48Z","receivedAt":"2020-01-24T21:01:53Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nMention #git-devel, which is targeted for Git contributors; asking for\nhelp with getting a first contribution together is on-topic for that\nchannel. Also mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, finally list the main Git list and mention some of the\nposting conventions.\n\nSigned-off-by: Emily Shaffer \n---\nSince v5, let the mailing list reference resolve to a mailto instead and\nadded an explicit link to the (read-only) archives.\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++\n 1 file changed, 33 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 35b9130aa3..c361b5d4ce 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,39 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== git@vger.kernel.org\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body. You can also browse the\n+https://lore.kernel.org/git[archives] in your browser.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.25.0.341.g760bfbb309-goog\n\n"},{"id":"390397","messageId":"xmqqy2twy2yw.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200124205025.GA140846@google.com","subject":"Re: [PATCH v5] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-01-24T21:11:19Z","receivedAt":"2020-01-24T21:11:28Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> On Fri, Jan 24, 2020 at 12:35:28PM -0800, Junio C Hamano wrote:\n>> emilyshaffer@google.com writes:\n>> \n>> > From: Emily Shaffer \n>> \n>> Hmm, unlike folks who use GGG, your From: address seem almost usable\n>> without having to waste two extra lines (which matters when one has\n>> to review many patches a day).\n>\n> Blame an unhealthy appreciation for being able to write emails in Vim.\n>\n> I generate patches with 'git format-patch' - what's the unusable part of\n> \"almost\" usable here?\n\nCompare your message I am responding here, with your message with\nthe patch in it.\n\nThis one has a perfectly usable \"From:\" address,\n\n From: Emily Shaffer \n\nwhile the patch e-mail has\n\n From: emilyshaffer@google.com\n\nwhich cannot be quite usable as the author identity.\n"},{"id":"390398","messageId":"xmqqtv4ky2mr.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200124210148.220007-1-emilyshaffer@google.com","subject":"Re: [PATCH v6] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-01-24T21:18:36Z","receivedAt":"2020-01-24T21:18:41Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> +This is the main Git project mailing list where code reviews, version\n> +announcements, design discussions, and more take place. The Git list\n> +requires plain-text-only emails and prefers inline and bottom-posting when\n> +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> +\"subscribe git\" in the body. You can also browse the\n> +https://lore.kernel.org/git[archives] in your browser.\n\nLet's not place a stress on non essential part (i.e. viewable in\nbrowser) over a more important stuff (i.e. this is where archive is\navailable). How about this as a replacement of the last sentence?\n\n\tThe archive of this mailing list is available at\n\thttps://lore.kernel.org/git[archives] to view in a browser.\n\n"},{"id":"390412","messageId":"20200124212013.GC140846@google.com","threadId":"52275","inReplyTo":"xmqqtv4ky2mr.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v6] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T21:20:13Z","receivedAt":"2020-01-24T21:20:19Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Fri, Jan 24, 2020 at 01:18:36PM -0800, Junio C Hamano wrote:\n> Emily Shaffer writes:\n> \n> > +This is the main Git project mailing list where code reviews, version\n> > +announcements, design discussions, and more take place. The Git list\n> > +requires plain-text-only emails and prefers inline and bottom-posting when\n> > +replying to mail; you will be CC'd in all replies to you. Optionally, you can\n> > +subscribe to the list by sending an email to majordomo@vger.kernel.org with\n> > +\"subscribe git\" in the body. You can also browse the\n> > +https://lore.kernel.org/git[archives] in your browser.\n> \n> Let's not place a stress on non essential part (i.e. viewable in\n> browser) over a more important stuff (i.e. this is where archive is\n> available). How about this as a replacement of the last sentence?\n> \n> \tThe archive of this mailing list is available at\n> \thttps://lore.kernel.org/git[archives] to view in a browser.\n\nSure. I'll send a reroll unless I hear from you before it's ready that\nyou took it with that change.\n"},{"id":"390414","messageId":"20200124212602.74194-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"20200124210148.220007-1-emilyshaffer@google.com","subject":"[PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-01-24T21:26:02Z","receivedAt":"2020-01-24T21:26:13Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\nnow have a mentoring mailing list, to which we should direct new\ncontributors who have questions.\n\nMention #git-devel, which is targeted for Git contributors; asking for\nhelp with getting a first contribution together is on-topic for that\nchannel. Also mention some of the conventions in case folks are\nunfamiliar with IRC.\n\nBecause the mentoring list and #git-devel are both a subset of Git\ncontributors, finally list the main Git list and mention some of the\nposting conventions.\n\nSigned-off-by: Emily Shaffer \n---\nTook a slightly modified version of Junio's suggestion for the archive\nlink so the final text reads \"The archive of this mailing list is\navailable to view in a browser\" instead of \"The archive of this mailing\nlist is available at archive to view in a browser\".\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 33 +++++++++++++++++++++++++++\n 1 file changed, 33 insertions(+)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 35b9130aa3..522c75099d 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -23,6 +23,39 @@ useful additional context:\n - `Documentation/SubmittingPatches`\n - `Documentation/howto/new-command.txt`\n \n+[[getting-help]]\n+=== Getting Help\n+\n+If you get stuck, you can seek help in the following places.\n+\n+==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n+\n+This mailing list is targeted to new contributors and is a great place to post\n+questions and receive kind, detailed answers from volunteers on the Git\n+project. You must join the group to view messages or post.\n+\n+==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n+\n+This IRC channel is for conversations between Git contributors. If someone is\n+currently online and knows the answer to your question, you can receive help\n+in real time. Otherwise, you can read the\n+https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see\n+whether someone answered you. IRC does not allow offline private messaging, so\n+if you try to private message someone and then log out of IRC, they cannot\n+respond to you. It's better to ask your questions in the channel so that you\n+can be answered if you disconnect and so that others can learn from the\n+conversation.\n+\n+==== git@vger.kernel.org\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. The Git list\n+requires plain-text-only emails and prefers inline and bottom-posting when\n+replying to mail; you will be CC'd in all replies to you. Optionally, you can\n+subscribe to the list by sending an email to majordomo@vger.kernel.org with\n+\"subscribe git\" in the body. The https://lore.kernel.org/git[archive] of this\n+mailing list is available to view in a browser.\n+\n [[getting-started]]\n == Getting Started\n \n-- \n2.25.0.341.g760bfbb309-goog\n\n"},{"id":"390416","messageId":"20200124215628.GI6837@szeder.dev","threadId":"52275","inReplyTo":"20200124212602.74194-1-emilyshaffer@google.com","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2020-01-24T21:56:28Z","receivedAt":"2020-01-24T21:56:34Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Fri, Jan 24, 2020 at 01:26:02PM -0800, Emily Shaffer wrote:\n> With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\n> now have a mentoring mailing list, to which we should direct new\n> contributors who have questions.\n\nWhy should a supposedly \"open\" open source project direct new\ncontributors to a mailing list that is not openly accessible, and even\nreading and searching its archives requires registration?\n\n"},{"id":"390417","messageId":"xmqqlfpwy0h1.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200124212602.74194-1-emilyshaffer@google.com","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-01-24T22:05:14Z","receivedAt":"2020-01-24T22:05:23Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Emily Shaffer writes:\n\n> Took a slightly modified version of Junio's suggestion for the archive\n> link so the final text reads \"The archive of this mailing list is\n> available to view in a browser\" instead of \"The archive of this mailing\n> list is available at archive to view in a browser\".\n\nLooks good. Thanks.\n"},{"id":"390424","messageId":"xmqqh80kctcn.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200124215628.GI6837@szeder.dev","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-01-24T23:44:40Z","receivedAt":"2020-01-24T23:44:50Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"SZEDER Gábor writes:\n\n> On Fri, Jan 24, 2020 at 01:26:02PM -0800, Emily Shaffer wrote:\n>> With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\n>> now have a mentoring mailing list, to which we should direct new\n>> contributors who have questions.\n>\n> Why should a supposedly \"open\" open source project direct new\n> contributors to a mailing list that is not openly accessible, and even\n> reading and searching its archives requires registration?\n\nHaven't we had that discussion when the mentoring list was launched?\n\nI would not prefer joining a closed list of unknown people over\ncoming up with a fake name and asking for help in an open list if I\nhad choice when interacting with an established community as a new\nmember, but I would understand it if preference of some people are\nopposite from mine. The more important part, from my point of view,\nis that we offer choices (the proposed doc update illustrates\nthree).\n\n"},{"id":"391234","messageId":"20200206010704.GN10482@szeder.dev","threadId":"52275","inReplyTo":"xmqqh80kctcn.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"SZEDER Gábor","fromEmail":"szeder.dev@gmail.com","sentAt":"2020-02-06T01:07:04Z","receivedAt":"2020-02-06T01:07:13Z","isPatch":true,"sender":{"key":"szeder.dev@gmail.com","avatar":"https://avatars.githubusercontent.com/u/116324?v=4"},"body":"On Fri, Jan 24, 2020 at 03:44:40PM -0800, Junio C Hamano wrote:\n> SZEDER Gábor writes:\n> \n> > On Fri, Jan 24, 2020 at 01:26:02PM -0800, Emily Shaffer wrote:\n> >> With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we\n> >> now have a mentoring mailing list, to which we should direct new\n> >> contributors who have questions.\n> >\n> > Why should a supposedly \"open\" open source project direct new\n> > contributors to a mailing list that is not openly accessible, and even\n> > reading and searching its archives requires registration?\n> \n> Haven't we had that discussion when the mentoring list was launched?\n> \n> I would not prefer joining a closed list of unknown people over\n> coming up with a fake name and asking for help in an open list if I\n> had choice when interacting with an established community as a new\n> member, but I would understand it if preference of some people are\n> opposite from mine. The more important part, from my point of view,\n> is that we offer choices (the proposed doc update illustrates\n> three).\n\nI remember a discussion about whether that list and its archive should\nbe open or closed, and I agree that offering choices is good.\nHowever, since that mentoring list requires registration, we have to\ncarefully consider how to present it to newcomers.\n\nOpenly accessible knowledge is a fundamental value, and it's the\nfoundation of open source. Therefore, we definitely should not direct\nnewcomers to a closed mailing list as the first option, it can only be\na fallback.\n\nThe text should list git@vger as the first option, since that's the\nonly open mailing list we have, it should clearly emphasize that\nnewcomers are very welcome, and should explicitly encourage them to\npost their questions here, no matter how trivial or silly they think\nthose questions are, we'll be always glad to answer them.\n\nThe closed mailing list can be mentioned third as a fallback for those\nwho would prefer not to end up on public record right away or who have\nany technical issues with posting to the main mailing list.\n\n"},{"id":"391254","messageId":"xmqqh803fzf1.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200206010704.GN10482@szeder.dev","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-02-06T16:33:54Z","receivedAt":"2020-02-06T16:34:07Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"SZEDER Gábor writes:\n\n> On Fri, Jan 24, 2020 at 03:44:40PM -0800, Junio C Hamano wrote:\n>\n>> ... The more important part, from my point of view,\n>> is that we offer choices (the proposed doc update illustrates\n>> three).\n>\n> I remember a discussion about whether that list and its archive should\n> be open or closed, and I agree that offering choices is good.\n> However, since that mentoring list requires registration, we have to\n> carefully consider how to present it to newcomers.\n>\n> Openly accessible knowledge is a fundamental value, and it's the\n> foundation of open source. Therefore, we definitely should not direct\n> newcomers to a closed mailing list as the first option, it can only be\n> a fallback.\n\nI am not that dogmatic ;-) I would be very unhappy and probably\nwould not have joined if the main development community was closed,\nbut I do not think the \"knowledge\" the \"closed mentoring list for\nthose who are shy\" are meant to impart to newbies will be something\nthat will be so well kept secret that are shared among only those in\nthe closed list. I expect the mentoring list to be repeating what\nthose who graduated \"new\"-ness consider pretty much common public\nknowledge.\n\nHaving said that, my reading did hiccup when queuing Emily's text,\nin that it listed the mentoring list first, and (more problematic)\nthe only choice among the three described with a word \"great\" was\nthat one. Also, now I re-read it, the last sentence \"You must join\nthe group to view messages or post\", without explaining why it is\nset up that way is bound to give a wrong impression, I suppose. I\npresume that the reason why those who wanted to make the mentoring\nlist closed was because they thought it would be nicer for shysters,\nbut if that is the case, it probably is better to spell that out.\n\n> The text should list git@vger as the first option, since that's the\n> only open mailing list we have, it should clearly emphasize that\n> newcomers are very welcome, and should explicitly encourage them to\n> post their questions here, no matter how trivial or silly they think\n> those questions are, we'll be always glad to answer them.\n\nI have no problem with seeing an expanded invitation to the main\nlist. I do not have a strong opinion on the order of three items.\n\n> The closed mailing list can be mentioned third as a fallback for those\n> who would prefer not to end up on public record right away or who have\n> any technical issues with posting to the main mailing list.\n\nI'll mark the topic on hold (it is in 'next'), and would give the\nstakeholders some time to settle the discussion, perhaps with\ncounter-proposals in an incremental patch form. Would it be\nreasonable to set the deadline around the end of the next week?\n"},{"id":"391268","messageId":"20200206194929.GA190927@google.com","threadId":"52275","inReplyTo":"xmqqh803fzf1.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-02-06T19:49:29Z","receivedAt":"2020-02-06T19:49:38Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Thu, Feb 06, 2020 at 08:33:54AM -0800, Junio C Hamano wrote:\n> SZEDER Gábor writes:\n> \n> > On Fri, Jan 24, 2020 at 03:44:40PM -0800, Junio C Hamano wrote:\n> >\n> >> ... The more important part, from my point of view,\n> >> is that we offer choices (the proposed doc update illustrates\n> >> three).\n> >\n> > I remember a discussion about whether that list and its archive should\n> > be open or closed, and I agree that offering choices is good.\n> > However, since that mentoring list requires registration, we have to\n> > carefully consider how to present it to newcomers.\n> >\n> > Openly accessible knowledge is a fundamental value, and it's the\n> > foundation of open source. Therefore, we definitely should not direct\n> > newcomers to a closed mailing list as the first option, it can only be\n> > a fallback.\n> \n> I am not that dogmatic ;-) I would be very unhappy and probably\n> would not have joined if the main development community was closed,\n> but I do not think the \"knowledge\" the \"closed mentoring list for\n> those who are shy\" are meant to impart to newbies will be something\n> that will be so well kept secret that are shared among only those in\n> the closed list. I expect the mentoring list to be repeating what\n> those who graduated \"new\"-ness consider pretty much common public\n> knowledge.\n> \n> Having said that, my reading did hiccup when queuing Emily's text,\n> in that it listed the mentoring list first, and (more problematic)\n> the only choice among the three described with a word \"great\" was\n> that one. Also, now I re-read it, the last sentence \"You must join\n> the group to view messages or post\", without explaining why it is\n> set up that way is bound to give a wrong impression, I suppose. I\n> presume that the reason why those who wanted to make the mentoring\n> list closed was because they thought it would be nicer for shysters,\n> but if that is the case, it probably is better to spell that out.\n\nSure. I think I didn't do so in an effort to be brief. I'll think on\nthis today and send some suggestions here (rather than rerolling).\n\n> \n> > The text should list git@vger as the first option, since that's the\n> > only open mailing list we have, it should clearly emphasize that\n> > newcomers are very welcome, and should explicitly encourage them to\n> > post their questions here, no matter how trivial or silly they think\n> > those questions are, we'll be always glad to answer them.\n> \n> I have no problem with seeing an expanded invitation to the main\n> list. I do not have a strong opinion on the order of three items.\n\nMe neither, and placing git@vger first does give me an opportunity to\nsay something like \"if you feel worried about asking publicly, this list\nis a more private setting\" in reference to the mentors list. So that's\nan option I could get behind.\n\n> \n> > The closed mailing list can be mentioned third as a fallback for those\n> > who would prefer not to end up on public record right away or who have\n> > any technical issues with posting to the main mailing list.\n> \n> I'll mark the topic on hold (it is in 'next'), and would give the\n> stakeholders some time to settle the discussion, perhaps with\n> counter-proposals in an incremental patch form. Would it be\n> reasonable to set the deadline around the end of the next week?\n\nYeah, that is OK for me. I'll try and send another email with some ideas\ntoday or tomorrow.\n\nThanks for the feedback, Gábor - I appreciate it.\n\n - Emily\n"},{"id":"391276","messageId":"20200206221305.GB190927@google.com","threadId":"52275","inReplyTo":"20200206194929.GA190927@google.com","subject":"Re: [PATCH v7] MyFirstContribution: add avenues for getting help","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-02-06T22:13:05Z","receivedAt":"2020-02-06T22:13:14Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Thu, Feb 06, 2020 at 11:49:29AM -0800, Emily Shaffer wrote:\n> On Thu, Feb 06, 2020 at 08:33:54AM -0800, Junio C Hamano wrote:\n> > SZEDER Gábor writes:\n> > \n> > > On Fri, Jan 24, 2020 at 03:44:40PM -0800, Junio C Hamano wrote:\n> > >\n> > >> ... The more important part, from my point of view,\n> > >> is that we offer choices (the proposed doc update illustrates\n> > >> three).\n> > >\n> > > I remember a discussion about whether that list and its archive should\n> > > be open or closed, and I agree that offering choices is good.\n> > > However, since that mentoring list requires registration, we have to\n> > > carefully consider how to present it to newcomers.\n> > >\n> > > Openly accessible knowledge is a fundamental value, and it's the\n> > > foundation of open source. Therefore, we definitely should not direct\n> > > newcomers to a closed mailing list as the first option, it can only be\n> > > a fallback.\n> > \n> > I am not that dogmatic ;-) I would be very unhappy and probably\n> > would not have joined if the main development community was closed,\n> > but I do not think the \"knowledge\" the \"closed mentoring list for\n> > those who are shy\" are meant to impart to newbies will be something\n> > that will be so well kept secret that are shared among only those in\n> > the closed list. I expect the mentoring list to be repeating what\n> > those who graduated \"new\"-ness consider pretty much common public\n> > knowledge.\n> > \n> > Having said that, my reading did hiccup when queuing Emily's text,\n> > in that it listed the mentoring list first, and (more problematic)\n> > the only choice among the three described with a word \"great\" was\n> > that one. Also, now I re-read it, the last sentence \"You must join\n> > the group to view messages or post\", without explaining why it is\n> > set up that way is bound to give a wrong impression, I suppose. I\n> > presume that the reason why those who wanted to make the mentoring\n> > list closed was because they thought it would be nicer for shysters,\n> > but if that is the case, it probably is better to spell that out.\n> \n> Sure. I think I didn't do so in an effort to be brief. I'll think on\n> this today and send some suggestions here (rather than rerolling).\n> \n> > \n> > > The text should list git@vger as the first option, since that's the\n> > > only open mailing list we have, it should clearly emphasize that\n> > > newcomers are very welcome, and should explicitly encourage them to\n> > > post their questions here, no matter how trivial or silly they think\n> > > those questions are, we'll be always glad to answer them.\n> > \n> > I have no problem with seeing an expanded invitation to the main\n> > list. I do not have a strong opinion on the order of three items.\n> \n> Me neither, and placing git@vger first does give me an opportunity to\n> say something like \"if you feel worried about asking publicly, this list\n> is a more private setting\" in reference to the mentors list. So that's\n> an option I could get behind.\n\nHow about something like this?\n\nI was trying to achieve the following goals:\n\n - Try to remove bias:\n - Don't make git@vger sound like a last-ditch effort or scary place.\n - Don't call git-mentoring@ \"great\", rather explain why it was\n created\n - Don't imply that all contributors who want to help are present on\n mentoring list, or that all contributors who aren't present on\n mentoring list don't want to help - just indicate that all\n contributors on mentoring list do want to help\n - Explain reasoning around git-mentoring@:\n - avoiding the public eye (and that's why viewing is restricted)\n - targeted membership (people joined because they want to help)\n\nI'm no professional writer, so I expect there's more work to be done.\nWhen we have something we're happy with then I'll send a formal patch.\n\n - Emily\n\n-- >8 --\n\n---\n Documentation/MyFirstContribution.txt | 29 +++++++++++++++------------\n 1 file changed, 16 insertions(+), 13 deletions(-)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 522c75099d..427274df4d 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -28,11 +28,24 @@ useful additional context:\n \n If you get stuck, you can seek help in the following places.\n \n+==== git@vger.kernel.org\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. Those interested in\n+contributing are welcome to post questions here. The Git list requires\n+plain-text-only emails and prefers inline and bottom-posting when replying to\n+mail; you will be CC'd in all replies to you. Optionally, you can subscribe to\n+the list by sending an email to majordomo@vger.kernel.org with \"subscribe git\"\n+in the body. The https://lore.kernel.org/git[archive] of this mailing list is\n+available to view in a browser.\n+\n ==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n \n-This mailing list is targeted to new contributors and is a great place to post\n-questions and receive kind, detailed answers from volunteers on the Git\n-project. You must join the group to view messages or post.\n+This mailing list is targeted to new contributors and was created as a place to\n+post questions and receive answers outside of the public eye of the main list.\n+Veteran contributors who are especially interested in helping mentor newcomers\n+are present on the list. In order to avoid search indexers, group membership is\n+required to view messages; anyone can join and no approval is required.\n \n ==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n \n@@ -46,16 +59,6 @@ respond to you. It's better to ask your questions in the channel so that you\n can be answered if you disconnect and so that others can learn from the\n conversation.\n \n-==== git@vger.kernel.org\n-\n-This is the main Git project mailing list where code reviews, version\n-announcements, design discussions, and more take place. The Git list\n-requires plain-text-only emails and prefers inline and bottom-posting when\n-replying to mail; you will be CC'd in all replies to you. Optionally, you can\n-subscribe to the list by sending an email to majordomo@vger.kernel.org with\n-\"subscribe git\" in the body. The https://lore.kernel.org/git[archive] of this\n-mailing list is available to view in a browser.\n-\n [[getting-started]]\n == Getting Started\n \n-- \n2.25.0.341.g760bfbb309-goog\n\n"},{"id":"391734","messageId":"20200214020359.17463-1-emilyshaffer@google.com","threadId":"52275","inReplyTo":"xmqqh803fzf1.fsf@gitster-ct.c.googlers.com","subject":"[PATCH] MyFirstContribution: rephrase contact info","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2020-02-14T02:03:59Z","receivedAt":"2020-02-14T02:04:06Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"Make an effort not to discourage new users from mailing questions to\ngit@vger.kernel.org, and explain the purpose of the mentoring list in\ncontrast to the main list.\n\nSigned-off-by: Emily Shaffer \n---\nSince I didn't hear any complaint about\nhttps://lore.kernel.org/git/20200206221305.GB190927@google.com, here it\nis in a real live commit. There is no difference from the scissors patch\nbut the commit message.\n\n - Emily\n\n Documentation/MyFirstContribution.txt | 29 +++++++++++++++------------\n 1 file changed, 16 insertions(+), 13 deletions(-)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex 522c75099d..427274df4d 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -28,11 +28,24 @@ useful additional context:\n \n If you get stuck, you can seek help in the following places.\n \n+==== git@vger.kernel.org\n+\n+This is the main Git project mailing list where code reviews, version\n+announcements, design discussions, and more take place. Those interested in\n+contributing are welcome to post questions here. The Git list requires\n+plain-text-only emails and prefers inline and bottom-posting when replying to\n+mail; you will be CC'd in all replies to you. Optionally, you can subscribe to\n+the list by sending an email to majordomo@vger.kernel.org with \"subscribe git\"\n+in the body. The https://lore.kernel.org/git[archive] of this mailing list is\n+available to view in a browser.\n+\n ==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]\n \n-This mailing list is targeted to new contributors and is a great place to post\n-questions and receive kind, detailed answers from volunteers on the Git\n-project. You must join the group to view messages or post.\n+This mailing list is targeted to new contributors and was created as a place to\n+post questions and receive answers outside of the public eye of the main list.\n+Veteran contributors who are especially interested in helping mentor newcomers\n+are present on the list. In order to avoid search indexers, group membership is\n+required to view messages; anyone can join and no approval is required.\n \n ==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode\n \n@@ -46,16 +59,6 @@ respond to you. It's better to ask your questions in the channel so that you\n can be answered if you disconnect and so that others can learn from the\n conversation.\n \n-==== git@vger.kernel.org\n-\n-This is the main Git project mailing list where code reviews, version\n-announcements, design discussions, and more take place. The Git list\n-requires plain-text-only emails and prefers inline and bottom-posting when\n-replying to mail; you will be CC'd in all replies to you. Optionally, you can\n-subscribe to the list by sending an email to majordomo@vger.kernel.org with\n-\"subscribe git\" in the body. The https://lore.kernel.org/git[archive] of this\n-mailing list is available to view in a browser.\n-\n [[getting-started]]\n == Getting Started\n \n-- \n2.25.0.265.gbab2e86ba0-goog\n\n"},{"id":"391735","messageId":"20200214021027.GA191976@google.com","threadId":"52275","inReplyTo":"20200214020359.17463-1-emilyshaffer@google.com","subject":"Re: [PATCH] MyFirstContribution: rephrase contact info","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2020-02-14T02:10:27Z","receivedAt":"2020-02-14T02:10:32Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Emily Shaffer wrote:\n\n> Make an effort not to discourage new users from mailing questions to\n> git@vger.kernel.org, and explain the purpose of the mentoring list in\n> contrast to the main list.\n>\n> Signed-off-by: Emily Shaffer \n> ---\n> Documentation/MyFirstContribution.txt | 29 +++++++++++++++------------\n> 1 file changed, 16 insertions(+), 13 deletions(-)\n\nReviewed-by: Jonathan Nieder \n\nThanks for tying up this loose end.\n"},{"id":"391774","messageId":"xmqqr1yxnkab.fsf@gitster-ct.c.googlers.com","threadId":"52275","inReplyTo":"20200214021027.GA191976@google.com","subject":"Re: [PATCH] MyFirstContribution: rephrase contact info","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2020-02-14T17:36:12Z","receivedAt":"2020-02-14T17:36:28Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jonathan Nieder writes:\n\n> Emily Shaffer wrote:\n>\n>> Make an effort not to discourage new users from mailing questions to\n>> git@vger.kernel.org, and explain the purpose of the mentoring list in\n>> contrast to the main list.\n>>\n>> Signed-off-by: Emily Shaffer \n>> ---\n>> Documentation/MyFirstContribution.txt | 29 +++++++++++++++------------\n>> 1 file changed, 16 insertions(+), 13 deletions(-)\n>\n> Reviewed-by: Jonathan Nieder \n>\n> Thanks for tying up this loose end.\n\nThanks, both. Let's merge this to 'next' and down to 'master', if\nwe do not hear a better suggestion while waiting for a couple more\ndays.\n"}]}