Re: [PATCH v5] MyFirstContribution: add avenues for getting help

[Junio C Hamano <gitster@pobox.com>]

emilyshaffer@google.com writes:

> From: Emily Shaffer <emilyshaffer@google.com>

Hmm, unlike folks who use GGG, your From: address seem almost usable
without having to waste two extra lines (which matters when one has
to review many patches a day).

> With https://lore.kernel.org/git/20191114194708.GD60198@google.com/ we
> now have a mentoring mailing list, to which we should direct new
> contributors who have questions.

Yay.

> Mention #git-devel, which is targeted for Git contributors; asking for
> help with getting a first contribution together is on-topic for that
> channel. Also mention some of the conventions in case folks are
> unfamiliar with IRC.
>
> Because the mentoring list and #git-devel are both a subset of Git
> contributors, finally list the main Git list and mention some of the
> posting conventions.

> +[[getting-help]]
> +=== Getting Help
> +
> +If you get stuck, you can seek help in the following places.
> +
> +==== https://groups.google.com/forum/#!forum/git-mentoring[git-mentoring@googlegroups.com]
> +
> +This mailing list is targeted to new contributors and is a great place to post
> +questions and receive kind, detailed answers from volunteers on the Git
> +project. You must join the group to view messages or post.

OK.


> +==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
> +
> +This IRC channel is for conversations between Git contributors. If someone is
> +currently online and knows the answer to your question, you can receive help
> +in real time. Otherwise, you can read the
> +https://colabti.org/irclogger/irclogger_logs/git-devel[scrollback] to see
> +whether someone answered you. IRC does not allow offline private messaging, so
> +if you try to private message someone and then log out of IRC, they cannot
> +respond to you. It's better to ask your questions in the channel so that you
> +can be answered if you disconnect and so that others can learn from the
> +conversation.

OK.

> +==== https://lore.kernel.org/git[git@vger.kernel.org]

Hmph.  I would have expected mailto:git@vger.kernel.org as the main
URL here, as this enumeration is not for those who lurk to passibly
receive information, but for those (new) contributors who want to
ask help by actively transmitting.  Mentioning lore as an archive
when talking about the list is necessary, but it shouldn't obscure
the main e-mail address people need to know in order to send their
requests.

> +
> +This is the main Git project mailing list where code reviews, version
> +announcements, design discussions, and more take place. The Git list
> +requires plain-text-only emails and prefers inline and bottom-posting when
> +replying to mail; you will be CC'd in all replies to you. Optionally, you can
> +subscribe to the list by sending an email to majordomo@vger.kernel.org with
> +"subscribe git" in the body.

Thanks.