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

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 meanwhile. Signed-off-by: Daniel P. Berrangé <berrange(a)redhat.com&gt; --- 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. </p> - <h2><a id="bugzilla">Bug Tracking</a></h2> + <h2><a id="bugtracking">Bug Tracking</a></h2> <p> If you are using libvirt binaries from a Linux distribution @@ -30,22 +30,17 @@ <h2><a id="general">General libvirt bug reports</a></h2> <p> - 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. </p> <p> 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 @@ </p> <ul> - <li><a href="http://bugzilla.redhat.com/buglist.cgi?component=libvirt&a... libvirt tickets</a></li> - <li><a href="http://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Virt... 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> </ul> + <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> <ul> <li> @@ -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. </p>