diff --git a/docs/best-practices.rst b/docs/best-practices.rst index 7c48ff10be..4a28b03b65 100644 --- a/docs/best-practices.rst +++ b/docs/best-practices.rst @@ -15,8 +15,9 @@ with minimal back-and-forth. by any longer description of why your patch makes sense. If the patch fixes a regression, and you know what commit introduced the problem, mentioning that is useful. If the patch resolves a - bugzilla report, mentioning the URL of the bug number is - useful; but also summarize the issue rather than making all + upstream bug reported in GitLab, put "Fixes: #NNN" in the commit + message. For a downstream bug, mention the URL of the bug instead. + In both cases also summarize the issue rather than making all readers follow the link. You can use 'git shortlog -30' to get an idea of typical summary lines. diff --git a/docs/bugs.html.in b/docs/bugs.html.in index 5534223384..fa2866f829 100644 --- a/docs/bugs.html.in +++ b/docs/bugs.html.in @@ -19,7 +19,7 @@ security process instead.

-

Bug Tracking

+

Bug Tracking

If you are using libvirt binaries from a Linux distribution @@ -30,22 +30,17 @@

General libvirt bug reports

- The Red Hat Bugzilla Server - should be used to report bugs and request features in libvirt. + Bugs in upstream libvirt code should be reported as issues in the + appropriate project on GitLab. Before submitting a ticket, check the existing tickets to see if the bug/feature is already tracked. - - For general libvirt bug reports, from self-built releases, GIT snapshots - and any other non-distribution supported builds, enter tickets under - the Virtualization Tools product and the libvirt - component.

It's always a good idea to file bug reports, as the process of filing the report always makes it easier to describe the problem, and the bug number provides a quick way of referring to - the problem. However, not everybody in the community pays - attention to bugzilla, so after you file a bug, asking questions + the problem. However, not everybody in the community pays frequent + attention to issues, so after you file a bug, asking questions and submitting patches on the libvirt mailing lists will increase your bug's visibility and encourage people to think about your problem. Don't hesitate to @@ -65,10 +60,16 @@

+

+ Note bugs in language bindings and other sub-projects should be + reported to their corresponding git repository rather than the + main libvirt.git linked above. +

+

Linux Distribution specific bug reports