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

[Thomas Huth]

On 26.07.2017 13:44, Paolo Bonzini wrote:
> 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.

Well, sometimes people still report bugs against QEMU 2.1 or so ... so
I'd say everything that is older than the current version - 2 has a very
high chance to be ignored completely. So maybe we should ask people to
use at least one of the versions that is mentioned on the front-page of
www.qemu.org ?

> 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.
>

Maybe better "front-end(s)" instead of "frontend(s)" ?

> -* 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

Thinking about the markup again, maybe better use "*not*" instead of
"NOT" (to avoid shouting).

Apart from that, looks fine to me, thanks for the update!

 Thomas