[PATCH] MyFirstContribution: link #git-devel to Libera Chat

[PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Atharva Raykar]

It's pretty safe to say that most of the regulars on #git-devel are now
on Libera Chat. This will help new contributors find the right place, if
they choose to ask questions on `#git-devel`.

Since there seems to be no way to directly link Libera's web chat to
`#git-devel` directly, I have put a generic link over the text 'Libera
Chat'. Users will have to manually type `#git-devel` in the webchat
interface, but that should be obvious enough to not be worth mentioning.

Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
---

My heuristic for determining "most of the regulars are on Libera Chat" is the
fact that the last biweekly standup happened there.

 Documentation/MyFirstContribution.txt | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
index af0a9da62e..cd9e2069d4 100644
--- a/Documentation/MyFirstContribution.txt
+++ b/Documentation/MyFirstContribution.txt
@@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
 are present on the list. In order to avoid search indexers, group membership is
 required to view messages; anyone can join and no approval is required.
 
-==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
+==== #git-devel on https://web.libera.chat[Libera Chat]
 
 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
@@ -826,9 +826,9 @@ NOTE: You can typically find someone who can `/allow` you on GitGitGadget by
 either examining recent pull requests where someone has been granted `/allow`
 (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
 is:pr is:open "/allow"]), in which case both the author and the person who
-granted the `/allow` can now `/allow` you, or by inquiring on the
-https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
-linking your pull request and asking for someone to `/allow` you.
+granted the `/allow` can now `/allow` you, or by inquiring on the #git-devel IRC
+channel on https://web.libera.chat[Libera Chat] linking your pull request and
+asking for someone to `/allow` you.
 
 If the CI fails, you can update your changes with `git rebase -i` and push your
 branch again:
-- 
2.31.1

Re: [PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Junio C Hamano]

Atharva Raykar <raykar.ath@gmail.com> writes:

> It's pretty safe to say that most of the regulars on #git-devel are now
> on Libera Chat. This will help new contributors find the right place, if
> they choose to ask questions on `#git-devel`.
>
> Since there seems to be no way to directly link Libera's web chat to
> `#git-devel` directly, I have put a generic link over the text 'Libera
> Chat'. Users will have to manually type `#git-devel` in the webchat
> interface, but that should be obvious enough to not be worth mentioning.
>
> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
> ---
>
> My heuristic for determining "most of the regulars are on Libera Chat" is the
> fact that the last biweekly standup happened there.

You CC'ed Emily as the area expert for this document, which is
excellent.  As she was present at the last standup there, I'd expect
her to give her Reviewed-by if the patch looks acceptable to her,
and I'll queue the patch if/when it happens.

Thanks.

Re: [PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Emily Shaffer]

On Tue, Jun 08, 2021 at 07:21:14PM +0530, Atharva Raykar wrote:
> 
> It's pretty safe to say that most of the regulars on #git-devel are now
> on Libera Chat. This will help new contributors find the right place, if
> they choose to ask questions on `#git-devel`.
> 
> Since there seems to be no way to directly link Libera's web chat to
> `#git-devel` directly,

I just typed "web.libera.chat/#git-devel" and it worked perfectly fine.

> I have put a generic link over the text 'Libera
> Chat'. Users will have to manually type `#git-devel` in the webchat
> interface, but that should be obvious enough to not be worth mentioning.

Generally, this is a bad approach to take for absolute-beginner
documents like this one. Even if it "should" be obvious, why not just
say it? Some skills - like how to examine the compiler errors from your
C compiler and fix your code accordingly - are a necessary prerequisite
to be useful on the Git project; other skills - like how to use IRC -
are not, and we can teach them, especially in a guide like this :)

But anyway it's moot, as direct link does seem to work.

> 
> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
> ---
> 
> My heuristic for determining "most of the regulars are on Libera Chat" is the
> fact that the last biweekly standup happened there.
> 
>  Documentation/MyFirstContribution.txt | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
> index af0a9da62e..cd9e2069d4 100644
> --- a/Documentation/MyFirstContribution.txt
> +++ b/Documentation/MyFirstContribution.txt
> @@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
>  are present on the list. In order to avoid search indexers, group membership is
>  required to view messages; anyone can join and no approval is required.
>  
> -==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
> +==== #git-devel on https://web.libera.chat[Libera Chat]

The prior link was a direct link to the #git-devel channel, so that
newbies don't need to figure out how to join the channel they want from
the main webchat landing page. It looks like Libera also supports this
functionality. So please link to 'https://web.libera.chat/#git-devel'
instead.

> @@ -826,9 +826,9 @@ NOTE: You can typically find someone who can `/allow` you on GitGitGadget by
>  either examining recent pull requests where someone has been granted `/allow`
>  (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
>  is:pr is:open "/allow"]), in which case both the author and the person who
> -granted the `/allow` can now `/allow` you, or by inquiring on the
> -https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
> -linking your pull request and asking for someone to `/allow` you.
> +granted the `/allow` can now `/allow` you, or by inquiring on the #git-devel IRC
> +channel on https://web.libera.chat[Libera Chat] linking your pull request and
> +asking for someone to `/allow` you.

Same as above.


Thanks very much for sending the patch. I haven't had time to address it
myself.

 - Emily

Re: [PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Emily Shaffer]

On Tue, Jun 08, 2021 at 07:21:14PM +0530, Atharva Raykar wrote:
> 
> It's pretty safe to say that most of the regulars on #git-devel are now
> on Libera Chat. This will help new contributors find the right place, if
> they choose to ask questions on `#git-devel`.

Ah, I forgot to say - it is probably better to link either to the
mailing list discussion or to the IRC chat logs than to say "It's safe
to say" in the commit message.

> 
> Since there seems to be no way to directly link Libera's web chat to
> `#git-devel` directly, I have put a generic link over the text 'Libera
> Chat'. Users will have to manually type `#git-devel` in the webchat
> interface, but that should be obvious enough to not be worth mentioning.
> 
> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
> ---
> 
> My heuristic for determining "most of the regulars are on Libera Chat" is the
> fact that the last biweekly standup happened there.
> 
>  Documentation/MyFirstContribution.txt | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
> index af0a9da62e..cd9e2069d4 100644
> --- a/Documentation/MyFirstContribution.txt
> +++ b/Documentation/MyFirstContribution.txt
> @@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
>  are present on the list. In order to avoid search indexers, group membership is
>  required to view messages; anyone can join and no approval is required.
>  
> -==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
> +==== #git-devel on https://web.libera.chat[Libera Chat]
>  
>  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
> @@ -826,9 +826,9 @@ NOTE: You can typically find someone who can `/allow` you on GitGitGadget by
>  either examining recent pull requests where someone has been granted `/allow`
>  (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
>  is:pr is:open "/allow"]), in which case both the author and the person who
> -granted the `/allow` can now `/allow` you, or by inquiring on the
> -https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
> -linking your pull request and asking for someone to `/allow` you.
> +granted the `/allow` can now `/allow` you, or by inquiring on the #git-devel IRC
> +channel on https://web.libera.chat[Libera Chat] linking your pull request and
> +asking for someone to `/allow` you.
>  
>  If the CI fails, you can update your changes with `git rebase -i` and push your
>  branch again:
> -- 
> 2.31.1
> 

Re: [PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Atharva Raykar]

On 08-Jun-2021, at 22:53, Emily Shaffer <emilyshaffer@google.com> wrote:
> 
> On Tue, Jun 08, 2021 at 07:21:14PM +0530, Atharva Raykar wrote:
>> 
>> It's pretty safe to say that most of the regulars on #git-devel are now
>> on Libera Chat. This will help new contributors find the right place, if
>> they choose to ask questions on `#git-devel`.
>> 
>> Since there seems to be no way to directly link Libera's web chat to
>> `#git-devel` directly,
> 
> I just typed "web.libera.chat/#git-devel" and it worked perfectly fine.
> 
>> I have put a generic link over the text 'Libera
>> Chat'. Users will have to manually type `#git-devel` in the webchat
>> interface, but that should be obvious enough to not be worth mentioning.
> 
> Generally, this is a bad approach to take for absolute-beginner
> documents like this one. Even if it "should" be obvious, why not just
> say it? Some skills - like how to examine the compiler errors from your
> C compiler and fix your code accordingly - are a necessary prerequisite
> to be useful on the Git project; other skills - like how to use IRC -
> are not, and we can teach them, especially in a guide like this :)

Got you. In fact, the fault in my reasoning was perfectly
demonstrated by the fact that I did not attempt one of the most
"obvious" ways to get the link to #git-devel directly.

I cannot decide what's obvious for other people :)

> But anyway it's moot, as direct link does seem to work.
> 
>> [...]
> 
> The prior link was a direct link to the #git-devel channel, so that
> newbies don't need to figure out how to join the channel they want from
> the main webchat landing page. It looks like Libera also supports this
> functionality. So please link to 'https://web.libera.chat/#git-devel'
> instead.

Sure. I'll send another patch.

> [...]
> 
> Thanks very much for sending the patch. I haven't had time to address it
> myself.
> 
> - Emily

[PATCH v2] MyFirstContribution: link #git-devel to Libera Chat

[Atharva Raykar]

Many of the regulars on #git-devel are now on Libera Chat, to the extent
that the community page now lists it as the IRC Channel[1]. This will
help new contributors find the right place, if they choose to ask
questions on `#git-devel`.

Relevant discussion on the IRC transition:
https://lore.kernel.org/git/CAJoAoZ=e62sceNpcR5L5zjsj177uczTnXjcAg+BbOoOkeH8vXQ@mail.gmail.com/

[1] https://git-scm.com/community

Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
---
 Documentation/MyFirstContribution.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
index af0a9da62e..d0bcb8c91f 100644
--- a/Documentation/MyFirstContribution.txt
+++ b/Documentation/MyFirstContribution.txt
@@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
 are present on the list. In order to avoid search indexers, group membership is
 required to view messages; anyone can join and no approval is required.
 
-==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
+==== https://web.libera.chat/#git-devel[#git-devel] on Libera Chat
 
 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
@@ -827,8 +827,8 @@ either examining recent pull requests where someone has been granted `/allow`
 (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
 is:pr is:open "/allow"]), in which case both the author and the person who
 granted the `/allow` can now `/allow` you, or by inquiring on the
-https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
-linking your pull request and asking for someone to `/allow` you.
+https://web.libera.chat/#git-devel[#git-devel] IRC channel on Libera Chat linking your
+pull request and asking for someone to `/allow` you.
 
 If the CI fails, you can update your changes with `git rebase -i` and push your
 branch again:
-- 
2.31.1

Re: [PATCH] MyFirstContribution: link #git-devel to Libera Chat

[Emily Shaffer]

On Tue, Jun 08, 2021 at 11:34:02PM +0530, Atharva Raykar wrote:
> 
> On 08-Jun-2021, at 22:53, Emily Shaffer <emilyshaffer@google.com> wrote:
> > 
> > On Tue, Jun 08, 2021 at 07:21:14PM +0530, Atharva Raykar wrote:
> >> 
> >> It's pretty safe to say that most of the regulars on #git-devel are now
> >> on Libera Chat. This will help new contributors find the right place, if
> >> they choose to ask questions on `#git-devel`.
> >> 
> >> Since there seems to be no way to directly link Libera's web chat to
> >> `#git-devel` directly,
> > 
> > I just typed "web.libera.chat/#git-devel" and it worked perfectly fine.
> > 
> >> I have put a generic link over the text 'Libera
> >> Chat'. Users will have to manually type `#git-devel` in the webchat
> >> interface, but that should be obvious enough to not be worth mentioning.
> > 
> > Generally, this is a bad approach to take for absolute-beginner
> > documents like this one. Even if it "should" be obvious, why not just
> > say it? Some skills - like how to examine the compiler errors from your
> > C compiler and fix your code accordingly - are a necessary prerequisite
> > to be useful on the Git project; other skills - like how to use IRC -
> > are not, and we can teach them, especially in a guide like this :)
> 
> Got you. In fact, the fault in my reasoning was perfectly
> demonstrated by the fact that I did not attempt one of the most
> "obvious" ways to get the link to #git-devel directly.
> 
> I cannot decide what's obvious for other people :)

Or maybe Libera thought it was too obvious to document? :thinkyface:

Thanks again, looking forward to v2 :)

 - Emily

[PATCH v3] MyFirstContribution: link #git-devel to Libera Chat

[Atharva Raykar]

Many of the regulars on #git-devel are now on Libera Chat, to the extent
that the community page now lists it as the IRC Channel[1]. This will
help new contributors find the right place, if they choose to ask
questions on `#git-devel`.

Relevant discussion on the IRC transition:
https://lore.kernel.org/git/CAJoAoZ=e62sceNpcR5L5zjsj177uczTnXjcAg+BbOoOkeH8vXQ@mail.gmail.com/

[1] https://git-scm.com/community

Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
---

I'm sending it again as my v2 had one line crossed 80 lines in my edit,
which broke the local convention.

 Documentation/MyFirstContribution.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
index af0a9da62e..015cf24631 100644
--- a/Documentation/MyFirstContribution.txt
+++ b/Documentation/MyFirstContribution.txt
@@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
 are present on the list. In order to avoid search indexers, group membership is
 required to view messages; anyone can join and no approval is required.
 
-==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
+==== https://web.libera.chat/#git-devel[#git-devel] on Libera Chat
 
 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
@@ -827,7 +827,7 @@ either examining recent pull requests where someone has been granted `/allow`
 (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
 is:pr is:open "/allow"]), in which case both the author and the person who
 granted the `/allow` can now `/allow` you, or by inquiring on the
-https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
+https://web.libera.chat/#git-devel[#git-devel] IRC channel on Libera Chat
 linking your pull request and asking for someone to `/allow` you.
 
 If the CI fails, you can update your changes with `git rebase -i` and push your
-- 
2.31.1

Re: [PATCH v3] MyFirstContribution: link #git-devel to Libera Chat

[Atharva Raykar]

On 09-Jun-2021, at 00:36, Atharva Raykar <raykar.ath@gmail.com> wrote:
> 
> Many of the regulars on #git-devel are now on Libera Chat, to the extent
> that the community page now lists it as the IRC Channel[1]. This will
> help new contributors find the right place, if they choose to ask
> questions on `#git-devel`.
> 
> Relevant discussion on the IRC transition:
> https://lore.kernel.org/git/CAJoAoZ=e62sceNpcR5L5zjsj177uczTnXjcAg+BbOoOkeH8vXQ@mail.gmail.com/
> 
> [1] https://git-scm.com/community
> 
> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
> ---
> 
> I'm sending it again as my v2 had one line crossed 80 lines in my edit,
> which broke the local convention.

s/crossed/cross/
s/80 lines/80 columns/

Re: [PATCH v3] MyFirstContribution: link #git-devel to Libera Chat

[Emily Shaffer]

On Wed, Jun 09, 2021 at 12:36:12AM +0530, Atharva Raykar wrote:
> 
> Many of the regulars on #git-devel are now on Libera Chat, to the extent
> that the community page now lists it as the IRC Channel[1]. This will
> help new contributors find the right place, if they choose to ask
> questions on `#git-devel`.
> 
> Relevant discussion on the IRC transition:
> https://lore.kernel.org/git/CAJoAoZ=e62sceNpcR5L5zjsj177uczTnXjcAg+BbOoOkeH8vXQ@mail.gmail.com/
> 
> [1] https://git-scm.com/community
> 
> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
Reviewed-by: Emily Shaffer <emilyshaffer@google.com>


Thanks Atharva! :)

 - Emily
> ---
> 
> I'm sending it again as my v2 had one line crossed 80 lines in my edit,
> which broke the local convention.
> 
>  Documentation/MyFirstContribution.txt | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
> index af0a9da62e..015cf24631 100644
> --- a/Documentation/MyFirstContribution.txt
> +++ b/Documentation/MyFirstContribution.txt
> @@ -47,7 +47,7 @@ Veteran contributors who are especially interested in helping mentor newcomers
>  are present on the list. In order to avoid search indexers, group membership is
>  required to view messages; anyone can join and no approval is required.
>  
> -==== https://webchat.freenode.net/#git-devel[#git-devel] on Freenode
> +==== https://web.libera.chat/#git-devel[#git-devel] on Libera Chat
>  
>  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
> @@ -827,7 +827,7 @@ either examining recent pull requests where someone has been granted `/allow`
>  (https://github.com/gitgitgadget/git/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22%2Fallow%22[Search:
>  is:pr is:open "/allow"]), in which case both the author and the person who
>  granted the `/allow` can now `/allow` you, or by inquiring on the
> -https://webchat.freenode.net/#git-devel[#git-devel] IRC channel on Freenode
> +https://web.libera.chat/#git-devel[#git-devel] IRC channel on Libera Chat
>  linking your pull request and asking for someone to `/allow` you.
>  
>  If the CI fails, you can update your changes with `git rebase -i` and push your
> -- 
> 2.31.1
> 

Re: [PATCH v3] MyFirstContribution: link #git-devel to Libera Chat

[Junio C Hamano]

Emily Shaffer <emilyshaffer@google.com> writes:

> On Wed, Jun 09, 2021 at 12:36:12AM +0530, Atharva Raykar wrote:
>> 
>> Many of the regulars on #git-devel are now on Libera Chat, to the extent
>> that the community page now lists it as the IRC Channel[1]. This will
>> help new contributors find the right place, if they choose to ask
>> questions on `#git-devel`.
>> 
>> Relevant discussion on the IRC transition:
>> https://lore.kernel.org/git/CAJoAoZ=e62sceNpcR5L5zjsj177uczTnXjcAg+BbOoOkeH8vXQ@mail.gmail.com/
>> 
>> [1] https://git-scm.com/community
>> 
>> Signed-off-by: Atharva Raykar <raykar.ath@gmail.com>
> Reviewed-by: Emily Shaffer <emilyshaffer@google.com>
>
>
> Thanks Atharva! :)
>
>  - Emily

Thanks, both.  Will queue.