[libvirt PATCH 1/6] docs: point users to gitlab for issue tracking

Daniel P. Berrangé berrange at redhat.com
Thu Apr 9 13:55:04 UTC 2020

Currently we use the "Virtualization Tools" product in Red Hat Bugzilla
for issue tracking upstream. This changes to point people to GitLab for
issue tracking.

Note that Bugzilla still has plenty of bugs present against libvirt.
Triaging these to determine what is still valid will be a separate
exercise. Bugzilla will be locked to prevent creation of new issues

Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
 docs/best-practices.rst |  5 +++--
 docs/bugs.html.in       | 27 ++++++++++++++-------------
 2 files changed, 17 insertions(+), 15 deletions(-)

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..c717fa813d 100644
--- a/docs/bugs.html.in
+++ b/docs/bugs.html.in
@@ -19,7 +19,7 @@
       <a href="securityprocess.html">security process</a> instead.
-    <h2><a id="bugzilla">Bug Tracking</a></h2>
+    <h2><a id="bugtracking">Bug Tracking</a></h2>
       If you are using libvirt binaries from a Linux distribution
@@ -30,22 +30,17 @@
     <h2><a id="general">General libvirt bug reports</a></h2>
-      The <a href="http://bugzilla.redhat.com">Red Hat Bugzilla Server</a>
-      should be used to report bugs and request features in libvirt.
+      Bugs in upstream libvirt code should be reported as issues in
+      the appropriate <a href="http://gitlab.com/libvirt">GitLab project.</a>
       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 <code>Virtualization Tools</code> product and the <code>libvirt</code>
-      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 <a href="contact.html">the libvirt
       mailing lists</a> will increase your bug's visibility and
       encourage people to think about your problem.  Don't hesitate to
@@ -65,10 +60,16 @@
-      <li><a href="http://bugzilla.redhat.com/buglist.cgi?component=libvirt&product=Virtualization%20Tools">View libvirt tickets</a></li>
-      <li><a href="http://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Virtualization%20Tools&component=libvirt">New libvirt ticket</a></li>
+      <li><a href="https://gitlab.com/libvirt/libvirt/-/issues">View libvirt.git tickets</a></li>
+      <li><a href="https://gitlab.com/libvirt/libvirt/-/issues/new">New libvirt.git ticket</a></li>
+    <p>
+      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.
+    </p>
     <h2><a id="distribution">Linux Distribution specific bug reports</a></h2>
@@ -85,7 +86,7 @@
           If you are using binaries from <strong>Red Hat Enterprise
           Linux</strong>, enter tickets against the Red Hat Enterprise
           Linux product that you're using (e.g., Red Hat Enterprise
-          Linux 6) and the <code>libvirt</code> component.  Red Hat
+          Linux 8) and the <code>libvirt</code> component.  Red Hat
           bugzilla has <a href="http://bugzilla.redhat.com">additional guidance</a> about getting support if
           you are a Red Hat customer.

More information about the libvir-list mailing list