dev-manual, ref-manual: Reorganized Bugzilla information

Fixes [YOCTO #11630]

Reorganized the way the information about entering bugs using
Bugzilla is arranged in the documentation set.  The dev-manual now
has a section that is purely procedural and steps the user through
the process of logging a new bug in the Bugzilla system.  The
ref-manual has a conceptual section that introduces the YP
implementation of Bugzilla by simply telling the user what it is
and what what its purpose is.

(From yocto-docs rev: 4bfba345010be7bc2866b819b9754bb06f93c91f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2017-06-13 08:25:59 -07:00
committed by Richard Purdie
parent 0dae0865ba
commit 741dddf11a
3 changed files with 114 additions and 56 deletions

View File

@@ -17,11 +17,41 @@
</section>
<section id='resources-bugtracker'>
<title>Tracking Bugs</title>
<title>Yocto Project Bugzilla</title>
<para>
If you find problems with the Yocto Project, you should report them using the
Bugzilla application at <ulink url='&YOCTO_BUGZILLA_URL;'></ulink>.
The Yocto Project uses its own implementation of
<ulink url='http://www.bugzilla.org/about/'>Bugzilla</ulink> to track
defects (bugs).
Implementations of Bugzilla work well for group development because
they track bugs and code changes, can be used to communicate changes
and problems with developers, can be used to submit and review patches,
and can be used to manage quality assurance.
</para>
<para>
Sometimes it is helpful to submit, investigate, or track a bug against
the Yocto Project itself (e.g. when discovering an issue with some
component of the build system that acts contrary to the documentation
or your expectations).
</para>
<para>
A general procedure and guidelines exist for when you use Bugzilla to
submit a bug.
For information on how to use Bugzilla to submit a bug against the
Yocto Project, see the following:
<itemizedlist>
<listitem><para>
The
"<ulink url='&YOCTO_DOCS_DEV_URL;#submitting-a-defect-against-the-yocto-project'>Submitting a Defect Against the Yocto Project</ulink>"
section in the Yocto Project Development Manual.
</para></listitem>
<listitem><para>
The Yocto Project
<ulink url='&YOCTO_WIKI_URL;/wiki/Bugzilla_Configuration_and_Bug_Tracking'>Bugzilla wiki page</ulink>
</para></listitem>
</itemizedlist>
</para>
</section>