X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=REPORTING-BUGS;h=327b6caa0889d0671c95f192200c76db6aec62d4;hb=acd2a882b53c0ddaf82d6123734f4b02327126d0;hp=ded68ab4fea9de3cfbc54385ad54b25cf7a30f2c;hpb=26eca2db3ef6e92ff1022099cb89fc8ce88ee15d;p=fio.git

diff --git a/REPORTING-BUGS b/REPORTING-BUGS
index ded68ab4..327b6caa 100644
--- a/REPORTING-BUGS
+++ b/REPORTING-BUGS
@@ -2,15 +2,20 @@ Reporting a bug
 ---------------
 
 If you notice anything that seems like a fio bug, please do send email
-to the list (fio@vger.kernel.org, see README) about it. You'll need
-to report at least:
+to the list (fio@vger.kernel.org, see README) about it. If you are not
+running the newest release of fio, upgrading first is recommended.
+
+When reporting a bug, you'll need to include:
 
 1) A description of what you think the bug is
 2) Environment (Linux distro version, kernel version). This is mostly
    needed if it's a build bug.
-3) The fio version. The most useful is the git top level commit, you
-   can find out by doing a cat .git/HEAD from the top level fio directory.
+3) The output from fio --version.
 4) How to reproduce. Please include a full list of the parameters
    passed to fio and the job file used (if any).
 
+A bug report can't have too much information. Any time information that
+is left out and has to be asked for will add to the turn-around time
+of getting to the bottom of the issue, and an eventual fix.
+
 That's it!