<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>2.2. Filing a Bug — Bugzilla 5.0.4 documentation</title>
<link rel="stylesheet" href="../_static/bugzilla.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '5.0.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="2.3. Understanding a Bug" href="understanding.html" />
<link rel="prev" title="2.1. Creating an Account" href="creating-an-account.html" />
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="understanding.html" title="2.3. Understanding a Bug"
accesskey="N">next</a></li>
<li class="right" >
<a href="creating-an-account.html" title="2.1. Creating an Account"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">2. User Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="filing-a-bug">
<span id="filing"></span><h1>2.2. Filing a Bug<a class="headerlink" href="#filing-a-bug" title="Permalink to this headline">¶</a></h1>
<div class="section" id="reporting-a-new-bug">
<h2>2.2.1. Reporting a New Bug<a class="headerlink" href="#reporting-a-new-bug" title="Permalink to this headline">¶</a></h2>
<p>Years of bug writing experience has been distilled for your
reading pleasure into the
<a class="reference external" href="http://landfill.bugzilla.org/bugzilla-tip/page.cgi?id=bug-writing.html">Bug Writing Guidelines</a>.
While some of the advice is Mozilla-specific, the basic principles of
reporting Reproducible, Specific bugs and isolating the Product you are
using, the Version of the Product, the Component which failed, the Hardware
Platform, and Operating System you were using at the time of the failure go a
long way toward ensuring accurate, responsible fixes for the bug that bit you.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">If you want to file a test bug to see how Bugzilla works,
you can do it on one of our test installations on
<a class="reference external" href="http://landfill.bugzilla.org/">Landfill</a>. Please don't do it on anyone's
production Bugzilla installation.</p>
</div>
<p>The procedure for filing a bug is as follows:</p>
<ol class="arabic">
<li><p class="first">Click the <span class="guilabel">New</span> link available in the header or footer
of pages, or the <span class="guilabel">File a Bug</span> link on the home page.</p>
</li>
<li><p class="first">First, you have to select the product in which you found a bug.</p>
</li>
<li><p class="first">You now see a form where you can specify the component (part of
the product which is affected by the bug you discovered; if you have
no idea, just select <span class="guilabel">General</span> if such a component exists),
the version of the program you were using, the operating system and
platform your program is running on and the severity of the bug (if the
bug you found crashes the program, it's probably a major or a critical
bug; if it's a typo somewhere, that's something pretty minor; if it's
something you would like to see implemented, then that's an enhancement).</p>
</li>
<li><p class="first">You also need to provide a short but descriptive summary of the bug you found.
"My program is crashing all the time" is a very poor summary
and doesn't help developers at all. Try something more meaningful or
your bug will probably be ignored due to a lack of precision.
In the Description, give a detailed list of steps to reproduce
the problem you encountered. Try to limit these steps to a minimum set
required to reproduce the problem. This will make the life of
developers easier, and the probability that they consider your bug in
a reasonable timeframe will be much higher.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Try to make sure that everything in the Summary is also in the
Description. Summaries are often updated and this will ensure your original
information is easily accessible.</p>
</div>
</li>
<li><p class="first">As you file the bug, you can also attach a document (testcase, patch,
or screenshot of the problem).</p>
</li>
<li><p class="first">Depending on the Bugzilla installation you are using and the product in
which you are filing the bug, you can also request developers to consider
your bug in different ways (such as requesting review for the patch you
just attached, requesting your bug to block the next release of the
product, and many other product-specific requests).</p>
</li>
<li><p class="first">Now is a good time to read your bug report again. Remove all misspellings;
otherwise, your bug may not be found by developers running queries for some
specific words, and so your bug would not get any attention.
Also make sure you didn't forget any important information developers
should know in order to reproduce the problem, and make sure your
description of the problem is explicit and clear enough.
When you think your bug report is ready to go, the last step is to
click the <span class="guilabel">Submit Bug</span> button to add your report into the database.</p>
</li>
</ol>
</div>
<div class="section" id="clone-an-existing-bug">
<span id="cloning-a-bug"></span><h2>2.2.2. Clone an Existing Bug<a class="headerlink" href="#clone-an-existing-bug" title="Permalink to this headline">¶</a></h2>
<p>Bugzilla allows you to "clone" an existing bug. The newly created bug will
inherit most settings from the old bug. This allows you to track similar
concerns that require different handling in a new bug. To use this, go to
the bug that you want to clone, then click the <span class="guilabel">Clone This Bug</span>
link on the bug page. This will take you to the <span class="guilabel">Enter Bug</span>
page that is filled with the values that the old bug has.
You can then change the values and/or text if needed.</p>
<hr class="docutils" />
<p>This documentation undoubtedly has bugs; if you find some, please file
them <a class="reference external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation">here</a>.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/bugzilla.png" alt="Logo"/>
</a></p>
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">2.2. Filing a Bug</a><ul>
<li><a class="reference internal" href="#reporting-a-new-bug">2.2.1. Reporting a New Bug</a></li>
<li><a class="reference internal" href="#clone-an-existing-bug">2.2.2. Clone an Existing Bug</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="creating-an-account.html"
title="previous chapter">2.1. Creating an Account</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="understanding.html"
title="next chapter">2.3. Understanding a Bug</a></p>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="understanding.html" title="2.3. Understanding a Bug"
>next</a></li>
<li class="right" >
<a href="creating-an-account.html" title="2.1. Creating an Account"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >2. User Guide</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6.
</div>
</body>
</html>
