Instructions for reporting bugs could be clearer

  • Open
  • quality assurance status badge
Details
3 participants
  • Adam Porter
  • Leo Famulari
  • Maxim Cournoyer
Owner
unassigned
Submitted by
Adam Porter
Severity
normal
A
A
Adam Porter wrote on 8 Mar 2020 14:19
help
(address . bug-guix@gnu.org)
CAO_b3FU8QV2tG-R_fnYDvKUe9K1kC5So2Ws1-1Kgw3bhftUYzw@mail.gmail.com

A
A
Adam Porter wrote on 8 Mar 2020 14:22
Re: bug#39983: Acknowledgement (help)
(address . 39983@debbugs.gnu.org)
CAO_b3FWejUJSkx6rAHuBY2_OA==WD5=9pb9dAVA40vixf2FyPA@mail.gmail.com
Okay, here's what happened:

1. I found a bug in Guix that I wanted to report.
2. I checked the manual, which directed me to https://issues.guix.gnu.org/.
3. That page directed me to "submit your patches or email
bug-guix@gnu.org to open a new issue." There were no further
instructions, so I guessed that sending an email with the body "help"
would return one with instructions on how to file an actual bug
report.
4. Instead, that filed a bug reporting "help."

Perhaps this bug could be repurposed into one about improving the
instructions for reporting bugs. :) Now I'll file the real bug
report...

On 3/8/20, GNU bug Tracking System <help-debbugs@gnu.org> wrote:
Toggle quote (22 lines)
> Thank you for filing a new bug report with debbugs.gnu.org.
>
> This is an automatically generated reply to let you know your message
> has been received.
>
> Your message is being forwarded to the package maintainers and other
> interested parties for their attention; they will reply in due course.
>
> Your message has been sent to the package maintainer(s):
> bug-guix@gnu.org
>
> If you wish to submit further information on this problem, please
> send it to 39983@debbugs.gnu.org.
>
> Please do not send mail to help-debbugs@gnu.org unless you wish
> to report a problem with the Bug-tracking system.
>
> --
> 39983: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=39983
> GNU Bug Tracking System
> Contact help-debbugs@gnu.org with problems
>
L
L
Leo Famulari wrote on 11 Mar 2020 20:00
(name . Adam Porter)(address . adam@alphapapa.net)(address . 39983@debbugs.gnu.org)
20200311190054.GB26593@jasmine.lan
On Sun, Mar 08, 2020 at 08:22:42AM -0500, Adam Porter wrote:
Toggle quote (15 lines)
> Okay, here's what happened:
>
> 1. I found a bug in Guix that I wanted to report.
> 2. I checked the manual, which directed me to https://issues.guix.gnu.org/.
> 3. That page directed me to "submit your patches or email
> bug-guix@gnu.org to open a new issue." There were no further
> instructions, so I guessed that sending an email with the body "help"
> would return one with instructions on how to file an actual bug
> report.
> 4. Instead, that filed a bug reporting "help."
>
> Perhaps this bug could be repurposed into one about improving the
> instructions for reporting bugs. :) Now I'll file the real bug
> report...

As a person that is super-experienced with reporting bugs in Guix, I
found the instructions perfectly clear :)

So, it's good to have feedback from somebody with fresh eyes. Can you
suggest any improvements to the text?
M
M
Maxim Cournoyer wrote on 5 May 2021 06:51
control message for bug #39983
(address . control@debbugs.gnu.org)
874kfhlr5u.fsf@gmail.com
retitle 39983 Instructions for reporting bugs could be clearer
quit
?