[libvirt PATCH 1/6] docs: point users to gitlab for issue tracking
Ján Tomko
jtomko at redhat.com
Thu Apr 9 14:33:04 UTC 2020
On a Thursday in 2020, Daniel P. Berrangé wrote:
>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 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.
> </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>
* please use https
* GitLab project makes it sound to me like "a project by GitLab"
<a href="https://gitlab.com/libvirt">project on GitLab</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&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>
> </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
unrelated change.
> bugzilla has <a href="http://bugzilla.redhat.com">additional guidance</a> about getting support if
> you are a Red Hat customer.
> </p>
Reviewed-by: Ján Tomko <jtomko at redhat.com>
Jano
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20200409/e91ea217/attachment-0001.sig>
More information about the libvir-list
mailing list