docs/BUGS

   1 How To Report A Bug
   2 ===================
   3
   4 If you think you've discovered a bug, please read through these guidelines
   5 before reporting it.
   6
   7 First, make sure it's a new bug:
   8
   9 * Are you using the very latest version of WiFi Radar?  The bug may have
  10   already been fixed.  Please get the latest version of WiFi Radar from
  11   the web site and check again.  Even if your bug has not been fixed,
  12   others probably have, and you're better off with the most up-to-date code.
  13
  14   If you don't have time to check the latest version, please report the bug
  15   anyway.  I'd rather tell you that it's already fixed than miss reports of
  16   unfixed bugs.
  17
  18 * If WiFi Radar does not behave the way you expect, look in the documentation
  19   (don't forget the FAQ) and, especially, the mailing list archives for
  20   evidence that it should behave the way you expect.
  21
  22 If you're not sure, please ask on the WiFi Radar mailing list first.
  23
  24 If it's a new bug, the most important thing you can do is to write a simple
  25 description and a recipe that reproduces the bug.  The easier you make it to
  26 understand and track down the bug, the more likely a fix will be.
  27
  28 Now you're ready to write the bug report.  Please include:
  29
  30 * A clear description of the bug.  Describe how you expected WiFi Radar to
  31   behave, and contrast that with how it actually behaved.  While the bug may
  32   seem obvious to you, it may not be so obvious to someone else, so it's best
  33   to avoid a guessing game.
  34
  35 * A complete description of the environment in which you reproduced the bug:
  36
  37   - Your operating system & version.
  38   - The version of Python ("python -V").
  39   - The version of WiFi Radar (use the "-v" option).
  40   - Decrease the logging threshold to 0 and send the resulting wifi-radar.log
  41     file.
  42   - Any private modifications you made to WiFi Radar.
  43   - Anything else that could possibly be relevant.  Err on the side of too
  44     much information, rather than too little.
  45
  46 * A literal transcript of the *exact* command you ran, and the *exact* output.
  47
  48 * If you also want to include speculation as to the cause, and even a patch to
  49   fix the bug, that would be great!
  50
  51 --
  52
  53 This document was blatantly stolen from Docutils 0.5.  The original version
  54 was written by David Goodger <goodger@python.org> and placed in the public
  55 domain.  This version, edited by Sean Robinson, is licensed under the
  56 Creative Commons Attribution License.  Please attribute both authors if you
  57 re-use it.