git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] git doc: direct bug reporters to mailing list archive (Re: [PATCH v2] git.txt: mention mailing list archive)

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Sep 28, 2018, 21:20 UTC
Message-ID
<20180928212049.GD193055@aiede.svl.corp.google.com>
In-Reply-To
<xmqq1s9def2p.fsf@gitster-ct.c.googlers.com>
Subject: git doc: direct bug reporters to mailing list archive

The mailing list archive can help a user encountering a bug to tell whether a recent regression has already been reported and whether a longstanding bug has already had some discussion to start their thinking.

Based-on-patch-by: Martin Ågren <martin.agren@gmail.com>
Improved-by: Junio C Hamano <gitster@pobox.com>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
Junio C Hamano wrote:
>> Jonathan Nieder wrote:
>>> Hm.  I think this encourages a behavior that I want to discourage:
>>> assuming that if a bug has already been reported then there's nothing
>>> more for the new user to add.
[...]
> Yup, in short I think any one of the above three is good enough.
> Let's just pick one and move on.  Unless somebody sends in an
> improvement that can be applied readily, by default I'll just "git
> am" the one Martin sent, as that is the easiest thing to do ;-).
I assume this is meant as a nudge, in which case nudge successful. ;-)

My experience is that bug reporters are very sensitive to hints the project gives about what kind of bugs they want to receive. I'd rather make use of that lesson now instead of waiting to relearn it in the wild. Here goes.

Thanks, both.
 Documentation/git.txt | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/Documentation/git.txt b/Documentation/git.txt
index 74a9d7edb4..8e6a92e8ba 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -858,7 +858,9 @@ Reporting Bugs
 
 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.
+subscribed to the list to send a message there.  See the list archive
+at https://public-inbox.org/git for previous bug reports and other
+discussions.
 
 Issues which are security relevant should be disclosed privately to
 the Git Security mailing list <git-security@googlegroups.com>.
-- 
2.19.0.605.g01d371f741
Previous: Junio C HamanoNext: Junio C Hamano
Message 9 of 12 in “git.txt: mention mailing list archive”
  1. git.txt: mention mailing list archiveMartin Ågren, Sep 19, 2018
  2. Junio C HamanoSep 20, 2018
  3. Martin ÅgrenSep 26, 2018
  4. Taylor BlauSep 26, 2018
  5. git.txt: mention mailing list archiveMartin Ågren, Sep 27, 2018
  6. Jonathan NiederSep 27, 2018
  7. Martin ÅgrenSep 27, 2018
  8. Junio C HamanoSep 28, 2018
  9. git doc: direct bug reporters to mailing list archive (Re: [PATCH v2] git.txt: mention mailing list archive)Jonathan Nieder, Sep 28, 2018
  10. Junio C HamanoSep 28, 2018
  11. Jonathan NiederSep 28, 2018
  12. Jonathan NiederSep 28, 2018

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.