All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Nieder <jrnieder@gmail.com>
To: Emily Shaffer <emilyshaffer@google.com>
Cc: git@vger.kernel.org, Jeff King <peff@peff.net>,
	Philippe Blain <levraiphilippeblain@gmail.com>
Subject: Re: [git-scm.com PATCH] community: advertise 'git-bugreport' tool
Date: Thu, 28 May 2020 17:27:57 -0700	[thread overview]
Message-ID: <20200529002757.GD114915@google.com> (raw)
In-Reply-To: <20200528231608.59507-1-emilyshaffer@google.com>

Emily Shaffer wrote:

> Starting with 2.27.0, 'git bugreport' can gather diagnostic info and
> drop the user into an editor with a template for a useful bugreport.
> Advertise this feature to users who want to report a bug in Git.
>
> Signed-off-by: Emily Shaffer <emilyshaffer@google.com>
> ---
>  app/views/community/index.html.erb       | 11 +++++++----

Modulo the link issue that Junio mentioned, LGTM.  I think the section
on the page you chose is a good place to mention the command.

> --- a/app/views/shared/ref/_debugging.html.erb
> +++ b/app/views/shared/ref/_debugging.html.erb
> @@ -2,5 +2,6 @@
>  <ul class='unstyled'>
>    <li><%= man('git-bisect') %></li>
>    <li><%= man('git-blame') %></li>
> +  <li><%= man('git-bugreport') %></li>
>    <li><%= man('git-grep') %></li>
>  </ul>

Where does this show up on the rendered page?  Is it
https://git-scm.com/book/en/v2/Appendix-C:-Git-Commands-Debugging?
Is there a way to preview how it renders?

That page appears to be about commands used to debug your own
codebase, so for everyone except us Git developers, it's the wrong
place to mention git bugreport. ;-)

Within the book, I think
https://git-scm.com/book/en/v2/Getting-Started-Getting-Help and the
corresponding
https://git-scm.com/book/en/v2/Appendix-C%3A-Git-Commands-Setup-and-Config
page might make sense.

Thanks,
Jonathan

  parent reply	other threads:[~2020-05-29  0:28 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-05-28 23:16 [git-scm.com PATCH] community: advertise 'git-bugreport' tool Emily Shaffer
2020-05-28 23:33 ` Junio C Hamano
2020-05-28 23:53   ` Emily Shaffer
2020-05-29  0:27 ` Jonathan Nieder [this message]
2020-05-29  3:24   ` Jeff King
2020-05-29  1:49 ` Philippe Blain
2020-05-29  3:33   ` Jeff King
2020-05-29  3:37 ` Jeff King

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200529002757.GD114915@google.com \
    --to=jrnieder@gmail.com \
    --cc=emilyshaffer@google.com \
    --cc=git@vger.kernel.org \
    --cc=levraiphilippeblain@gmail.com \
    --cc=peff@peff.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.