[Qemu-devel] [qemu-web PATCH] add Thomas's bug reporting dos and don'ts

[Paolo Bonzini]

We don't want the page to become too long, but these are good suggestions.

Also tone down the sentence about using the latest release or latest git
tree, though we do prefer those.

Signed-off-by: Paolo Bonzini <address@hidden>
---
 contribute.md              |  2 +-
 contribute/report-a-bug.md | 13 ++++++++++---
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/contribute.md b/contribute.md
index e052654..b10ba7f 100644
--- a/contribute.md
+++ b/contribute.md
@@ -3,7 +3,7 @@ title: Contribute to QEMU!
 permalink: /contribute/
 ---
 
-* Report a bug: https://bugs.launchpad.net/qemu/<br>[How to report a 
bug](report-a-bug/)
+* Report a bug: 
[https://bugs.launchpad.net/qemu/](https://bugs.launchpad.net/qemu/)<br>[How to 
report a bug](report-a-bug/)
 
 * Clone the git repository: <br>`git clone git://git.qemu-project.org/qemu.git`
 
diff --git a/contribute/report-a-bug.md b/contribute/report-a-bug.md
index ce73d76..81eecf7 100644
--- a/contribute/report-a-bug.md
+++ b/contribute/report-a-bug.md
@@ -3,17 +3,24 @@ title: Reporting a bug
 permalink: /contribute/report-a-bug/
 ---
 
-Bugs can be filed at our [bug tracker](https://bugs.launchpad.net/qemu/), 
which is hosted on Launchpad.
+Bugs can be filed at our [bug tracker](https://bugs.launchpad.net/qemu/), 
which is hosted on Launchpad. If you've got a problem with how your Linux 
distribution packages QEMU, use the bug tracker from your distro instead.
 
 When submitting a bug report, please try to do the following:
 
-* Make sure you're reporting the bug against the [latest 
release](/download/#source).  If possible, please try to reproduce with the 
latest development tree too.
+* Include the QEMU release version or the git commit hash into the 
description, so that it is later still clear in which version you have found 
the bug.  Reports against the [latest release](/download/#source) or even the 
latest development tree are usually acted upon faster.
 
 * Include the full command line used to launch the QEMU guest.
 
 * Reproduce the problem directly with a QEMU command-line.  Avoid frontends 
and management stacks, to ensure that the bug is in QEMU itself and not in a 
frontend.
 
-* Include as information about the guest (operating system, version, 
32/64-bit).
+* Include as information about the host and guest (operating system, version, 
32/64-bit).
 
 * Do not contribute patches on the bug tracker; send patches to the mailing 
list. Follow QEMU's [guidelines about submitting 
patches](http://wiki.qemu.org/Contribute/SubmitAPatch).
 
+Do NOT report security issues (or other bugs, too) as
+"private" bugs in the bug tracker.  QEMU has a [security
+process](http://wiki.qemu.org/SecurityProcess) for issues that should
+be reported in a non-public way instead.
+
+For problems with KVM in the kernel, use the kernel bug tracker instead;
+the [KVM wiki](http://www.linux-kvm.org/page/Bugs) has the details.
-- 
2.13.3