Skip to content

Commit

Permalink
Docs: Add a tips section to REPORTING-BUGS.
Browse files Browse the repository at this point in the history
Lots of grumpy maintainers would love to have annoying newbies and
disorganized bug reporters read Eric S. Raymond's "How To Ask Questions
The Smart Way".  Simon Tatham's "How to Report Bugs Effectively" is also
relevant.

It's likely no one will bother to read these, but it does give
maintainers something to point to.

Signed-off-by: Sarah Sharp <[email protected]>
  • Loading branch information
Sarah Sharp committed Apr 18, 2013
1 parent bc6bed4 commit bf6adaf
Showing 1 changed file with 13 additions and 0 deletions.
13 changes: 13 additions & 0 deletions REPORTING-BUGS
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,19 @@ information on the linux-kernel mailing list see
http://www.tux.org/lkml/).


Tips for reporting bugs
-----------------------

If you haven't reported a bug before, please read:

http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
http://www.catb.org/esr/faqs/smart-questions.html

It's REALLY important to report bugs that seem unrelated as separate email
threads or separate bugzilla entries. If you report several unrelated
bugs at once, it's difficult for maintainers to tease apart the relevant
data.

[Some of this is taken from Frohwalt Egerer's original linux-kernel FAQ]

Gather information
Expand Down

0 comments on commit bf6adaf

Please sign in to comment.