Re: git bug reporting

From: Bryan Jacobs <bjacobs@woti.com>
Date: Aug 29, 2011, 19:34 UTC
Message-ID: <20110829153448.190baaa1@robyn.woti.com>
In-Reply-To: <20110829192618.GF756@sigill.intra.peff.net>

On Mon, 29 Aug 2011 15:26:18 -0400 Jeff King <peff@peff.net> wrote:

Show 14 quoted lines

> On Mon, Aug 29, 2011 at 01:20:52PM -0400, Bryan Jacobs wrote:
> 
> > Dear git Developers,
> > 
> > Apologies if this is not the right forum for bug reports. I was
> > unable to find a Bugzilla/Redmine/Flyspray instance for issue
> > maintenance, nor some "proper procedure" on the git web page.
> 
> Yes, this is the right place. This question seems to be coming up a
> lot lately. And indeed, looking at the webpage and the wiki, we are
> not very clear that the mailing list is the place for such things.
> 
> Do you mind telling us where you looked? That will give us at least
> one spot that we know should be more clear. :)

I looked at the git-scm.com main page, the "documentation" sub-page, the wiki front page, and googled the site for terms like "issue tracker" and "bug reports", then read the FAQ.

Show 17 quoted lines

> In the meantime, I've updated:
> 
>   1. The GitCommunity wiki page to mention that bug reports should go
>      to the list.
> 
>   2. Added an entry "How do I report a bug in git?" to the FAQ on the
>      wiki.
> 
>   3. Sent Scott a patch for git-scm.org to mention bug reporting under
>      the big "Got questions" banner on the front page that points
> people to the mailing list. Pull request is here:
> 
>        https://github.com/schacon/gitscm/pull/11
> 
>      It may make sense to have a specific page on reporting bugs, and
>      link to it via a bigger "how to report bugs" somewhere on the
> front page of git-scm.org.

Thank you very much for your efforts. It looks like you hit all but one of the places I looked. I agree that having a link from some part of the git-scm landing page would make sense, that's common practice for software projects and seems to me a logical place for it. I (obviously) read the text under the "got questions" bit; it was what sent me to this list. If it had said "report a bug here" I would have felt more confident about sending this message.

Bryan Jacobs