Re: [PATCH] git.txt: mention mailing list archive

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 20, 2018, 19:07 UTC
Message-ID: <xmqqlg7wyol5.fsf@gitster-ct.c.googlers.com>
In-Reply-To: <6319b34fc808ff6d8948e59f381cc5342b9ef17d.1537375332.git.martin.agren@gmail.com>

Martin Ågren <martin.agren@gmail.com> writes:

> In the "Reporting Bugs" section of git(1), we refer to the mailing list,
> but we do not give any hint about where the archives might be found.

And why is it a good idea to give that information in Reporting Bugs section? Are we asking the bug reporters to look for similar issues in the archive before they send their message? If so, I think that we should be explicit about it, too. Otherwise, the list archive location would look like an irrelevant noise to those who wanted to find the address to report bugs to.

For example, we can say something like this:

>  Report bugs to the Git mailing list <git@vger.kernel.org> where the
>  development and maintenance is primarily done.  You do not have to be
>  subscribed to the list to send a message there.

  +If you want to check to see if the issue has
  +been reported already, the list archive can be found at
  +<https://public-inbox.org/git/> and other places.