unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: rms@gnu.org
Cc: memnon+usenet@freeshell.org, emacs-devel@gnu.org
Subject: Re: Emacs project mission (was Re: "If you're still seeing problems,  please reopen." [
Date: Mon, 02 Dec 2019 17:42:48 +0200	[thread overview]
Message-ID: <831rtmn37r.fsf@gnu.org> (raw)
In-Reply-To: <E1ibeSm-0004M0-IO@fencepost.gnu.org> (message from Richard Stallman on Mon, 02 Dec 2019 00:41:36 -0500)

> From: Richard Stallman <rms@gnu.org>
> Date: Mon, 02 Dec 2019 00:41:36 -0500
> Cc: emacs-devel@gnu.org
> 
> I just checked the section Reporting Bugs of the Emacs Manual and was
> surprised to see that it asks users to look in debbugs.
> 
> That requires substantial work, and substantial knowledge that users
> otherwise would not need to have, so it is a substantial
> discouragement to reporting bugs.
> 
> It also asks users to look at several mailing lists.  That too is a
> discouragement.
> 
> If we want to encourage users to report bugs, the obvious way is to
> delete those recommendations.  Let's tell users, "It's better to risk
> a duplicate bug report than risk leaving a bug unreported."

I disagree with what you say here, at least with the details of your
proposal.  There are ways of making that chapter in the manual better,
but just removing this section is IMO not a step in that direction.
Here's why I think so.

First, that section was written in response to a bug report, see

  https://lists.gnu.org/archive/html/bug-gnu-emacs/2010-06/msg00509.html

So at least the person who filed that bug did care about having this
information in the manual.

Next, every decent bug tracker has a feature whereby it shows related
bugs; some even do that before they let you file a new bug.  Debbugs
doesn't have such (semi-)automatic feature, but if we move to a more
sophisticated tracker, or enhance debbugs, we will have to
re-introduce a variant of that section anyway, so why remove it now?

Moreover, I cannot disagree more with the notion of "it's better to
risk a duplicate bug report than risk leaving a bug unreported."
Having to deal with duplicate bugs eats up precious time and resources
(realize the bug is a dupe, mark it so in the database, write an email
saying it's a dupe, etc.), of which we don't have enough.  Duplicate
bugs within hours or days of one another are a matter of routine here,
and any method of making these typical floods of similar reports
smaller is a net win for us.  I agree that we shouldn't ask users to
look too far back into the bug reports (so the reference to
emacs-pretest-bug should probably be removed nowadays), but a simple
search via the debbugs page, or a casual skimming thorough the last
week or two of messages on the bug list and emacs-devel, is a small
effort that is likely to bring significant gains, and I do want to
leave them there.  OTOH, the risk that an important bug will be left
unreported is nowadays very small, since a lot of people are tracking
the development branch, and several distros offer snapshot releases.
Thus, we don't need to be afraid of bugs going unreported anymore as
much as we did in the past.

Last, but certainly not least, that chapter is anyway quite long.  It
includes, in addition to "Known Problems", the following sections:

  . Bug Criteria -- when an issue is really a bug
  . Understanding Bug Reporting -- how to describe a bug
  . Checklist -- what information to include in a bug report and how
    to obtain that information

This is quite a lot of material to digest if you are serious about bug
reporting and really read all that stuff before filing a bug.  If we
think what's in the "Known Problems" section requires substantial
work, then the other sections require much more.  Do we remove all
that as well?  I hope not.

And finally, we have strong indications that almost no one reads this
stuff anyway.  We have people reporting duplicates, we have people
(even quite experienced ones) reporting problems without the minimal
information about their build/system, sometimes even without a clear
description of what they did to trigger the issue.  My interpretation
of this is that this chapter is more like a repository of good ideas
and techniques to point users at, not a must-do list of prerequisites
for reporting a bug; it certainly isn't treated as such by our users.
It is therefore not a substantial discouragement, let alone an
obstacle, to reporting bugs, not in practice.

So what does all that mean in terms of improving the UX of bug
reporting?  We could add a short checklist "for the impatient" right
at the beginning of the chapter, describing concisely the necessary
steps, and then encourage them to read the rest, saying that this will
make the bug report be more useful and help the Emacs developers
identify and resolve the issue much more efficiently.  But I would
definitely object to removing these sections, including "Known
Problems", from the chapter, as most of that is very useful, and if
followed, makes the bug reports much easier to deal with.



  reply	other threads:[~2019-12-02 15:42 UTC|newest]

Thread overview: 276+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <mailman.1688.1573976224.13325.bug-gnu-emacs@gnu.org>
2019-11-17 11:30 ` "If you're still seeing problems, please reopen." [Was: bug#25148:] Alan Mackenzie
2019-11-17 11:38   ` Lars Ingebrigtsen
2019-11-17 17:42     ` Óscar Fuentes
2019-11-17 17:49       ` Lars Ingebrigtsen
2019-11-17 17:58         ` Óscar Fuentes
2019-11-19  6:08           ` Richard Stallman
2019-11-17 18:02         ` Eli Zaretskii
2019-11-17 18:06         ` Dmitry Gutov
2019-11-17 18:09           ` Lars Ingebrigtsen
2019-11-17 18:15             ` Dmitry Gutov
2019-11-17 18:27               ` Andreas Schwab
2019-11-17 18:36               ` Lars Ingebrigtsen
2019-11-17 18:37                 ` Dmitry Gutov
2019-11-17 18:38                   ` Lars Ingebrigtsen
2019-11-17 18:51                   ` Eli Zaretskii
2019-11-18 14:10                 ` Stefan Kangas
2019-11-19  8:27                   ` Lars Ingebrigtsen
2019-11-19  9:56                     ` Robert Pluim
2019-11-19 11:00                       ` Michael Albinus
2019-11-20 11:12                       ` Lars Ingebrigtsen
2019-11-21 16:38                         ` Zach Pearson
2019-11-19  6:09               ` Richard Stallman
2019-11-19 11:14                 ` Dmitry Gutov
2019-11-19 16:13                   ` Eli Zaretskii
2020-01-01  1:19                 ` Michael Heerdegen
2020-01-01  5:32                   ` Drew Adams
2020-01-01 10:48                     ` VanL
2020-01-01 15:30                   ` Eli Zaretskii
2020-01-01 15:45                     ` Ihor Radchenko
2020-01-02  2:35                     ` Michael Heerdegen
2020-01-02 23:45                       ` Michael Welsh Duggan
2020-01-22 12:31                       ` Lars Ingebrigtsen
2019-11-17 20:14             ` Juanma Barranquero
2019-11-17 21:33             ` João Távora
2019-11-17 22:05               ` dick.r.chiang
2019-11-17 22:19                 ` Amin Bandali
2019-11-17 22:56                   ` João Távora
2019-11-18  7:38                     ` Michael Albinus
2019-11-18  8:46                       ` Lars Ingebrigtsen
2019-11-18  8:54                         ` Michael Albinus
2019-11-18  8:59                           ` Lars Ingebrigtsen
2019-11-18  9:16                             ` Michael Albinus
2019-11-18  9:17                               ` Lars Ingebrigtsen
2019-11-18  9:23                                 ` Michael Albinus
2019-11-18  9:30                                   ` Lars Ingebrigtsen
2019-11-18 10:10                                     ` Andreas Schwab
2019-11-18 11:12                                       ` Michael Albinus
2019-11-18 10:52                                     ` Michael Albinus
2019-11-18 11:35                     ` dick.r.chiang
2019-11-19  4:58                     ` Amin Bandali
2019-11-17 18:28           ` Eli Zaretskii
2019-11-23  8:06             ` Steinar Bang
2019-11-17 17:59       ` Eli Zaretskii
2019-11-17 18:11         ` Dmitry Gutov
2019-11-17 18:29           ` Eli Zaretskii
2019-11-17 18:25         ` Óscar Fuentes
2019-11-17 18:45           ` Eli Zaretskii
2019-11-17 19:07             ` Óscar Fuentes
2019-11-17 19:25               ` Alan Mackenzie
2019-11-17 19:53                 ` Óscar Fuentes
2019-11-17 19:59                   ` Lars Ingebrigtsen
2019-11-17 20:03                     ` Dmitry Gutov
2019-11-17 20:09                       ` Lars Ingebrigtsen
2019-11-17 20:16                         ` Dmitry Gutov
2019-11-17 20:22                           ` Lars Ingebrigtsen
2019-11-17 20:35                             ` Dmitry Gutov
2019-11-18  8:42                               ` Lars Ingebrigtsen
2019-11-18 11:24                                 ` Dmitry Gutov
2019-11-18 11:28                                   ` Lars Ingebrigtsen
2019-11-18 11:36                                     ` João Távora
2019-11-18 12:04                                       ` Dmitry Gutov
2019-11-18 12:21                                         ` João Távora
2019-11-18 11:58                                 ` Michael Albinus
2019-11-17 20:36                       ` Eli Zaretskii
2019-11-17 20:57                         ` Dmitry Gutov
2019-11-18  3:24                           ` Eli Zaretskii
2019-11-18 14:02                             ` Dmitry Gutov
2019-11-18 14:46                               ` Stefan Kangas
2019-11-19  8:32                                 ` Lars Ingebrigtsen
2019-11-18 16:12                               ` Eli Zaretskii
2019-12-02  1:20                                 ` Dmitry Gutov
2019-11-19  6:08                       ` Richard Stallman
2019-11-19 11:15                         ` Dmitry Gutov
2019-11-19 16:14                           ` Eli Zaretskii
2019-11-20 11:15                             ` Lars Ingebrigtsen
2019-11-20 16:25                               ` Eli Zaretskii
2019-11-20 16:53                                 ` João Távora
2019-11-20 17:43                                   ` Eli Zaretskii
2019-11-20 19:29                                     ` João Távora
2019-11-20 20:02                                       ` Eli Zaretskii
2019-11-20 20:12                                         ` João Távora
2019-11-21 14:49                                           ` Eli Zaretskii
2019-11-21 15:00                                             ` João Távora
2019-11-21 15:06                                               ` Dmitry Gutov
2019-11-21 15:09                                                 ` João Távora
2019-11-21 15:15                                                   ` Dmitry Gutov
2019-11-21 15:10                                               ` Eli Zaretskii
2019-11-21 15:30                                                 ` João Távora
2019-11-21 18:26                                                   ` Eli Zaretskii
2019-11-21 19:16                                                     ` João Távora
2019-11-21 19:32                                                       ` Eli Zaretskii
2019-11-23 13:10                                                         ` Richard Stallman
2019-11-21 20:04                                                     ` Dmitry Gutov
2019-11-22  7:07                                                       ` Eli Zaretskii
2019-11-22  8:23                                                         ` Dmitry Gutov
2019-11-22  9:14                                                           ` Eli Zaretskii
2019-11-22  9:46                                                             ` João Távora
2019-11-22 10:02                                                               ` Eli Zaretskii
2019-11-22 10:16                                                                 ` João Távora
2019-11-22 10:26                                                                   ` Eli Zaretskii
2019-11-21 12:24                                 ` Lars Ingebrigtsen
2019-11-21 14:27                                   ` Eli Zaretskii
2019-11-21 14:28                                     ` Lars Ingebrigtsen
2019-11-17 20:00                 ` Stefan Monnier
2019-11-19  6:08                 ` Richard Stallman
2019-11-17 19:47               ` Eli Zaretskii
2019-11-17 20:32               ` Juanma Barranquero
2019-11-18 16:22             ` Perry E. Metzger
2019-11-18 17:04               ` Eli Zaretskii
2019-11-18 22:23                 ` Perry E. Metzger
2019-11-18 17:59           ` John Wiegley
2019-11-18 18:14             ` Alan Mackenzie
2019-11-18 18:17             ` João Távora
2019-11-18 20:53               ` John Wiegley
2019-11-19  7:41               ` Michael Albinus
2019-11-19 16:05                 ` Eli Zaretskii
2019-11-18 19:25             ` Dmitry Gutov
2019-11-18 22:56             ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [Was: bug#25148:]) Perry E. Metzger
2019-11-18 23:40               ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [ dick.r.chiang
2019-11-19  7:58               ` Lars Ingebrigtsen
2019-11-19 19:50                 ` John Wiegley
2019-11-20  8:20                   ` Michael Albinus
2019-11-20  9:11                     ` Dmitry Gutov
2019-11-20  9:23                       ` Michael Albinus
2019-11-20  9:39                         ` Dmitry Gutov
2019-11-20  9:51                           ` Michael Albinus
2019-11-20 10:34                             ` Dmitry Gutov
2019-11-20 10:56                               ` Michael Albinus
2019-11-20 21:49                               ` João Távora
2019-11-21  3:06                           ` Richard Stallman
2019-11-21 10:27                             ` Dmitry Gutov
2019-11-22  3:38                               ` Richard Stallman
2019-11-22 12:29                                 ` Lars Ingebrigtsen
2019-11-22 13:12                                   ` Yuri Khan
2019-11-23 13:14                                     ` Richard Stallman
2019-11-23 13:58                                       ` Yuri Khan
2019-11-23 23:06                                         ` Richard Stallman
2019-11-24  3:19                                           ` HaiJun Zhang
2019-11-25  6:52                                       ` Sergey Organov
2019-11-22 17:14                                   ` Drew Adams
2019-11-23  0:05                                     ` Emanuel Berg via Emacs development discussions.
2019-11-25  3:11                                       ` Richard Stallman
2019-11-25  3:32                                         ` Emanuel Berg via Emacs development discussions.
2019-11-26  3:46                                           ` Richard Stallman
2019-11-26 20:55                                             ` Emanuel Berg via Emacs development discussions.
2019-11-25  7:03                                       ` Sergey Organov
2019-11-25  7:44                                         ` Emanuel Berg via Emacs development discussions.
2019-11-26  3:45                                           ` Richard Stallman
2019-11-26  5:44                                             ` Drew Adams
2019-11-26 15:18                                               ` Stefan Kangas
2019-11-26 16:24                                                 ` Drew Adams
2019-11-27  6:44                                               ` Richard Stallman
2019-11-27 11:38                                                 ` Lars Ingebrigtsen
2019-11-27 15:22                                                   ` Drew Adams
2019-11-27 16:00                                                   ` Eli Zaretskii
2019-11-27 16:16                                                     ` Lars Ingebrigtsen
2019-11-27 16:28                                                       ` Eli Zaretskii
2019-11-27 16:51                                                         ` Lars Ingebrigtsen
2019-11-28  9:36                                                   ` Stefan Kangas
2019-11-28 16:30                                                     ` Drew Adams
2019-11-29  5:26                                                       ` Richard Stallman
2019-11-29  6:53                                                         ` Drew Adams
2019-11-29  6:15                                                       ` Pankaj Jangid
2019-11-29  6:32                                                         ` Drew Adams
2019-11-29  5:32                                                     ` Lars Ingebrigtsen
2019-11-27 15:14                                                 ` Drew Adams
2019-11-26 18:07                                             ` defaults contents of report-emacs-bug Glenn Morris
2019-11-27  5:00                                               ` Sergey Organov
2019-11-27  5:01                                               ` Sergey Organov
2019-11-23 13:14                                   ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [ Richard Stallman
2019-11-23  0:37                                 ` Dmitry Gutov
2019-11-23  8:36                                   ` Michael Albinus
2019-11-23 10:11                                     ` Dmitry Gutov
2019-11-23 13:28                                       ` VanL
2019-11-23 16:04                                       ` Michael Albinus
2019-11-23 16:39                                         ` Eli Zaretskii
2019-11-23 17:56                                         ` Dmitry Gutov
2019-11-24  1:57                                           ` Drew Adams
2019-11-24  2:45                                             ` Perry E. Metzger
2019-11-24  3:44                                               ` Emanuel Berg via Emacs development discussions.
2019-11-25  3:18                                                 ` Richard Stallman
2019-11-25  3:34                                                   ` Emanuel Berg via Emacs development discussions.
2019-11-26  3:46                                                     ` Richard Stallman
2019-11-26 20:52                                                       ` Emanuel Berg via Emacs development discussions.
2019-11-24 18:31                                               ` Drew Adams
2019-11-24 21:59                                                 ` Emanuel Berg via Emacs development discussions.
2019-11-24  3:42                                             ` Eli Zaretskii
2019-11-24 20:16                                             ` Michael Albinus
2019-11-24 21:42                                               ` Drew Adams
2019-11-28 10:20                                           ` Philippe Vaucher
2019-11-27 23:56                                         ` Per Starbäck
2019-11-28  0:48                                           ` Emanuel Berg via Emacs development discussions.
2019-11-28 10:43                                           ` Michael Albinus
2019-11-29  5:21                                           ` Richard Stallman
2019-11-23 11:59                                     ` Lars Ingebrigtsen
2019-11-25  3:11                                   ` Richard Stallman
2019-11-25 16:50                                     ` Karl Fogel
2019-11-29  9:17                                     ` Memnon Anon
2019-12-02  5:41                                       ` Richard Stallman
2019-12-02 15:42                                         ` Eli Zaretskii [this message]
2019-12-02 23:57                                           ` Jean-Christophe Helary
2019-12-03  4:15                                             ` Emanuel Berg via Emacs development discussions.
2019-12-03 13:48                                           ` Emanuel Berg via Emacs development discussions.
2019-11-21 14:14                             ` Eli Zaretskii
2019-11-21 17:59                               ` Emacs project mission (was Re: "If you're still seeing problems, please reopen.") Alan Mackenzie
2019-11-21 18:18                                 ` Eli Zaretskii
2019-11-21 20:42                                   ` Perry E. Metzger
2019-11-22  3:42                                   ` Richard Stallman
2019-11-21 19:07                                 ` Dmitry Gutov
2019-11-23 13:09                                   ` Richard Stallman
2019-11-21 21:32                                 ` John Wiegley
2019-11-22  2:08                                   ` Alan Mackenzie
2019-11-22  4:30                                     ` John Wiegley
2019-11-25 20:43                                       ` Alan Mackenzie
2019-11-23 13:20                                     ` Richard Stallman
2019-11-22  3:41                                   ` Richard Stallman
2019-11-22  3:41                                   ` Richard Stallman
2019-11-21 20:26                               ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [ Perry E. Metzger
2019-11-21 21:18                                 ` John Wiegley
2019-11-22  3:42                               ` Richard Stallman
2019-11-22  8:12                                 ` Eli Zaretskii
2019-11-20 11:05                       ` Achim Gratz
2019-11-21  3:06                         ` Richard Stallman
2019-11-20 14:01                       ` Stefan Monnier
2019-11-21 12:15                         ` Lars Ingebrigtsen
2019-11-24 22:06                           ` David Engster
2019-11-24 23:58                             ` Óscar Fuentes
2019-11-22 14:28                       ` Benjamin Riefenstahl
2019-12-30  0:17                       ` Richard Stallman
2019-12-30  7:54                         ` Tim Cross
2019-12-31  0:40                           ` Richard Stallman
2019-11-20 10:44                     ` Lars Ingebrigtsen
2019-11-20 11:00                       ` Michael Albinus
2019-11-20 11:03                         ` Lars Ingebrigtsen
2019-11-20 11:39                           ` Michael Albinus
2019-11-20 11:49                             ` Lars Ingebrigtsen
2019-11-20 13:28                               ` Dmitry Gutov
2019-11-20 13:55                                 ` Michael Albinus
2019-11-20 14:04                                   ` Dmitry Gutov
2019-11-20 14:23                                     ` Michael Albinus
2019-11-21 11:57                                     ` Lars Ingebrigtsen
2019-11-21 13:50                                       ` Dmitry Gutov
2019-11-21 15:14                                         ` Lars Ingebrigtsen
2019-11-21 15:17                                           ` Dmitry Gutov
2019-11-21 15:20                                             ` Lars Ingebrigtsen
2019-11-21 15:28                                               ` Eli Zaretskii
2019-11-21 15:52                                                 ` Stefan Monnier
2019-11-21 18:05                                                   ` Eli Zaretskii
2019-11-23 13:11                                         ` Richard Stallman
2019-11-21 11:58                                   ` Lars Ingebrigtsen
2019-11-20 16:27                             ` Eli Zaretskii
2019-11-20 19:27                               ` Yuri Khan
2019-11-20 19:31                                 ` Eli Zaretskii
2019-11-20 19:44                                   ` Yuri Khan
2019-11-20 19:49                                     ` Robert Pluim
2019-11-20 19:46                                   ` Dmitry Gutov
2019-11-20 20:08                                     ` Eli Zaretskii
2019-11-21 12:02                                     ` Lars Ingebrigtsen
2019-11-23 16:58                                       ` Stefan Kangas
2019-11-20 23:53                         ` Perry E. Metzger
2019-11-20 16:19               ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [Was: bug#25148:]) Richard Stallman
2019-11-20 16:50                 ` Emacs project mission (was Re: "If you're still seeing problems, please reopen." [ John Wiegley
2019-11-17 19:36       ` "If you're still seeing problems, please reopen." [Was: bug#25148:] dick.r.chiang
2019-11-18 18:22         ` Karl Fogel
2019-11-20 16:37           ` Christopher Lemmer Webber
2019-11-20 17:41             ` Eli Zaretskii

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

  List information: https://www.gnu.org/software/emacs/

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

  git send-email \
    --in-reply-to=831rtmn37r.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=memnon+usenet@freeshell.org \
    --cc=rms@gnu.org \
    /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.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).