REPORTING-BUGS: Rewrite based on experience.
authorBen Pfaff <blp@nicira.com>
Mon, 13 Sep 2010 16:16:29 +0000 (09:16 -0700)
committerBen Pfaff <blp@nicira.com>
Tue, 14 Sep 2010 16:27:42 +0000 (09:27 -0700)
Burying the description of the problem, which is usually the most important
part in my experience, at the bottom of the REPORTING-BUGS file might be
the reason why we don't get good descriptions sometimes.  It is certainly
not the reason in other cases, but we might as well prioritize a bit
better.

REPORTING-BUGS

index 75da3d6ebe17738445a5d84a5a9f4532a8fdd898..812bfba0fb1c6486db96a46591a298976fcfa1c8 100644 (file)
@@ -5,8 +5,17 @@ We are eager to hear from users about problems that they have
 encountered with Open vSwitch.  This file documents how best to report
 bugs so as to ensure that they can be fixed as quickly as possible.
 
-Please report bugs by sending email to bugs@openvswitch.org.  Include
-as much of the following information as you can in your report:
+Please report bugs by sending email to bugs@openvswitch.org.  
+
+The most important parts of your bug report are the following:
+
+       * What you did that make the problem appear.
+
+       * What you expected to happen.
+
+       * What actually happened.
+
+Please also include the following information:
 
         * The Open vSwitch version number (as output by "ovs-vswitchd
           --version").
@@ -16,6 +25,8 @@ as much of the following information as you can in your report:
 
         * Any local patches or changes you have applied (if any).
 
+The following are also handy sometimes:
+
         * The kernel version on which Open vSwitch is running (from
           /proc/version) and the distribution and version number of
           your OS (e.g. "Centos 5.0").
@@ -28,15 +39,7 @@ as much of the following information as you can in your report:
         * If you have Open vSwitch configured to connect to an
           OpenFlow controller, the output of "ovs-ofctl show <bridge>"
           for each <bridge> configured in the vswitchd configuration
-          file.
-
-        * A description of the problem, which should include:
-
-                - What you did that make the problem appear.
-
-                - What you expected to happen.
-
-                - What actually happened.
+          database.
 
         * A fix or workaround, if you have one.