163 lines
13 KiB
HTML
163 lines
13 KiB
HTML
<html><head><title>Bug Triage</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Bug Triage</h1></div>
|
||
|
||
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
||
<ul>
|
||
<li class="toclevel-1 tocsection-1"><a href="#Why"><span class="tocnumber">1</span> <span class="toctext">Why</span></a></li>
|
||
<li class="toclevel-1 tocsection-2"><a href="#How_to_Triage"><span class="tocnumber">2</span> <span class="toctext">How to Triage</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-3"><a href="#Ticket_Status"><span class="tocnumber">2.1</span> <span class="toctext">Ticket Status</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-4"><a href="#New"><span class="tocnumber">2.1.1</span> <span class="toctext">New</span></a></li>
|
||
<li class="toclevel-3 tocsection-5"><a href="#Acknowledged"><span class="tocnumber">2.1.2</span> <span class="toctext">Acknowledged</span></a></li>
|
||
<li class="toclevel-3 tocsection-6"><a href="#Feedback"><span class="tocnumber">2.1.3</span> <span class="toctext">Feedback</span></a></li>
|
||
<li class="toclevel-3 tocsection-7"><a href="#Confirmed"><span class="tocnumber">2.1.4</span> <span class="toctext">Confirmed</span></a></li>
|
||
<li class="toclevel-3 tocsection-8"><a href="#Assigned"><span class="tocnumber">2.1.5</span> <span class="toctext">Assigned</span></a></li>
|
||
<li class="toclevel-3 tocsection-9"><a href="#Resolved"><span class="tocnumber">2.1.6</span> <span class="toctext">Resolved</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-10"><a href="#Ticket_Resolutio.C9.B2"><span class="tocnumber">2.2</span> <span class="toctext">Ticket Resolutioɲ</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-11"><a href="#Open"><span class="tocnumber">2.2.1</span> <span class="toctext">Open</span></a></li>
|
||
<li class="toclevel-3 tocsection-12"><a href="#Fixed"><span class="tocnumber">2.2.2</span> <span class="toctext">Fixed</span></a></li>
|
||
<li class="toclevel-3 tocsection-13"><a href="#Unable_to_reproduce"><span class="tocnumber">2.2.3</span> <span class="toctext">Unable to reproduce</span></a></li>
|
||
<li class="toclevel-3 tocsection-14"><a href="#Duplicate"><span class="tocnumber">2.2.4</span> <span class="toctext">Duplicate</span></a></li>
|
||
<li class="toclevel-3 tocsection-15"><a href="#No_change_required"><span class="tocnumber">2.2.5</span> <span class="toctext">No change required</span></a></li>
|
||
<li class="toclevel-3 tocsection-16"><a href="#Won.27t_fix"><span class="tocnumber">2.2.6</span> <span class="toctext">Won't fix</span></a></li>
|
||
<li class="toclevel-3 tocsection-17"><a href="#Not_fixable"><span class="tocnumber">2.2.7</span> <span class="toctext">Not fixable</span></a></li>
|
||
<li class="toclevel-3 tocsection-18"><a href="#Reopened"><span class="tocnumber">2.2.8</span> <span class="toctext">Reopened</span></a></li>
|
||
<li class="toclevel-3 tocsection-19"><a href="#Suspended"><span class="tocnumber">2.2.9</span> <span class="toctext">Suspended</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-20"><a href="#Ticket_Priority"><span class="tocnumber">2.3</span> <span class="toctext">Ticket Priority</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-21"><a href="#Immediat.C9.99"><span class="tocnumber">2.3.1</span> <span class="toctext">Immediatə</span></a></li>
|
||
<li class="toclevel-3 tocsection-22"><a href="#Urgent"><span class="tocnumber">2.3.2</span> <span class="toctext">Urgent</span></a></li>
|
||
<li class="toclevel-3 tocsection-23"><a href="#High"><span class="tocnumber">2.3.3</span> <span class="toctext">High</span></a></li>
|
||
<li class="toclevel-3 tocsection-24"><a href="#Normal"><span class="tocnumber">2.3.4</span> <span class="toctext">Normal</span></a></li>
|
||
<li class="toclevel-3 tocsection-25"><a href="#Low"><span class="tocnumber">2.3.5</span> <span class="toctext">Low</span></a></li>
|
||
<li class="toclevel-3 tocsection-26"><a href="#None"><span class="tocnumber">2.3.6</span> <span class="toctext">None</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-27"><a href="#Ticket_Severity"><span class="tocnumber">2.4</span> <span class="toctext">Ticket Severity</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-28"><a href="#Block"><span class="tocnumber">2.4.1</span> <span class="toctext">Block</span></a></li>
|
||
<li class="toclevel-3 tocsection-29"><a href="#Crash"><span class="tocnumber">2.4.2</span> <span class="toctext">Crash</span></a></li>
|
||
<li class="toclevel-3 tocsection-30"><a href="#Major"><span class="tocnumber">2.4.3</span> <span class="toctext">Major</span></a></li>
|
||
<li class="toclevel-3 tocsection-31"><a href="#Minor"><span class="tocnumber">2.4.4</span> <span class="toctext">Minor</span></a></li>
|
||
<li class="toclevel-3 tocsection-32"><a href="#Tweak"><span class="tocnumber">2.4.5</span> <span class="toctext">Tweak</span></a></li>
|
||
<li class="toclevel-3 tocsection-33"><a href="#Text"><span class="tocnumber">2.4.6</span> <span class="toctext">Text</span></a></li>
|
||
<li class="toclevel-3 tocsection-34"><a href="#Trivial"><span class="tocnumber">2.4.7</span> <span class="toctext">Trivial</span></a></li>
|
||
<li class="toclevel-3 tocsection-35"><a href="#Feature"><span class="tocnumber">2.4.8</span> <span class="toctext">Feature</span></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-36"><a href="#Tagging_Tickets"><span class="tocnumber">3</span> <span class="toctext">Tagging Tickets</span></a></li>
|
||
<li class="toclevel-1 tocsection-37"><a href="#Related"><span class="tocnumber">4</span> <span class="toctext">Related</span></a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
<h2><span class="mw-headline" id="Why">Why</span></h2>
|
||
<p><code>Triageː
|
||
</p><p>1a : the sorting of and allocation of treatment to patients and especially battle and disaster victims according to a system of priorities designed to maximize the number of survivors
|
||
</p><p>1b : the sorting of patients (as in an emergency room) according to the urgency of their need for care
|
||
</p><p>2: the assigning of priority order to projects on the basis of where funds and other resources can be best used, are most needed, or are most likely to achieve success </code>
|
||
</p><p>Bug triage is important to organize and prioritize bugs/features/patches in respect to the FreeCAD <a href="Tracker.html" title="Tracker">Bug Tracker</a>. If this task is neglected a project can suffer from what is called 'Bugtracker Bloat' which is essentially neglected tickets accumulating and rotting. Triage also helps to identify duplicate tickets that have a tendency to accumulate especially if there is a long standing unresolved issue that the FC team is well aware of but doesn't have the resources for whatever reason to fix at the time.
|
||
</p>
|
||
<h2><span class="mw-headline" id="How_to_Triage">How to Triage</span></h2>
|
||
<h3><span class="mw-headline" id="Ticket_Status">Ticket Status</span></h3>
|
||
<h4><span class="mw-headline" id="New">New</span></h4>
|
||
<p>Per MantisBT docsː
|
||
<code>This is the landing status for new issues. Issues stay in this status until they areː assigned, acknowledged, confirmed or resolved. </code>
|
||
</p><p>In other words, <b>NEW</b> status indicates several thingsː
|
||
</p>
|
||
<ol><li> Ticket hasn't been confirmed.</li>
|
||
<li> Ticket is still in process, i.e. Triage/Devs still evaluating/clarifying details of ticket from OP.</li>
|
||
<li> FreeCAD team hasn't decided what to do with this ticket yet.</li></ol>
|
||
<p>All current <a rel="nofollow" class="external text" href="https://freecadweb.org/tracker/view_all_set.php?type=1&temporary=y&status=10&hide_status=80">open FreeCAD tickets with <b>NEW</b> status</a>.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Acknowledged">Acknowledged</span></h4>
|
||
<h4><span class="mw-headline" id="Feedback">Feedback</span></h4>
|
||
<p>Tickets get designated this status when OP is being requested to provide more information.
|
||
</p><p>The ticket is pending based on the participation of OP. For exampleː the ticket is missing FC version info; or perhaps a certain 3rd party library name or version is required etc... Devs need to set this status whenever replying to OP in order to indicate that the ticket is pending. This is important due to the possibilit that OP neglects to respond which has a high probability for the ticket to 'rot' in the tracker.
|
||
</p><p>When OP responds the ticket status changes back to <b>New</b> automatically. Then ticket needs to be re-examined to decide what is needed.
|
||
</p><p>Further discussion on this topic in the <a rel="nofollow" class="external text" href="https://forum.freecadweb.org/viewtopic.php?f=10&t=23005">FreeCAD forum</a>.
|
||
</p><p>All current <a rel="nofollow" class="external text" href="https://freecadweb.org/tracker/view_all_set.php?type=1&temporary=y&status=20&hide_status=80">open FreeCAD tickets with <b>FEEDBACK</b> status</a> in the FC bugtracker.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Confirmed">Confirmed</span></h4>
|
||
<p>When a ticket is confirmed it has been eitherː
|
||
</p>
|
||
<ul><li> a bug that has been reproduced </li>
|
||
<li> a feature that has been greenlit to be considered valid. </li></ul>
|
||
<p>It is now ready to be assigned to or by a dev.
|
||
</p><p>All current <a rel="nofollow" class="external text" href="https://freecadweb.org/tracker/view_all_set.php?type=1&temporary=y&status=40&hide_status=80">open FreeCAD tickets with <b>CONFIRMED</b> status</a> in the FC tracker.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Assigned">Assigned</span></h4>
|
||
<p>Self-explanatory, these tickets that have been assigned to a specific developer.
|
||
</p><p>All current <a rel="nofollow" class="external text" href="https://freecadweb.org/tracker/view_all_set.php?type=1&temporary=y&status=50&hide_status=80">open FreeCAD tickets with <b>ASSIGNED</b> status</a> in the FC tracker.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Resolved">Resolved</span></h4>
|
||
<p>These tickets have been resolved but not closed yet, most likely because they need confirmation that the ticket has been fixed.
|
||
</p>
|
||
<hr />
|
||
<h3><span class="mw-headline" id="Ticket_Resolutio.C9.B2">Ticket Resolutioɲ</span></h3>
|
||
<h4><span class="mw-headline" id="Open">Open</span></h4>
|
||
<p>Self-explanatory, all tickets remain as 'open' if they are still relevant at the discretion of the FC team.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Fixed">Fixed</span></h4>
|
||
<p>Tickets that have been fixed.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Unable_to_reproduce">Unable to reproduce</span></h4>
|
||
<p>Tickets deemed un-reproducible
|
||
</p>
|
||
<h4><span class="mw-headline" id="Duplicate">Duplicate</span></h4>
|
||
<p>Tickets that are or have a duplicate ticket.
|
||
</p>
|
||
<h4><span class="mw-headline" id="No_change_required">No change required</span></h4>
|
||
<p>Tickets were it has been ascertained that no modifications are necessary.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Won.27t_fix">Won't fix</span></h4>
|
||
<p>FC team has rejected the ticket request for whatever reason stated.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Not_fixable">Not fixable</span></h4>
|
||
<h4><span class="mw-headline" id="Reopened">Reopened</span></h4>
|
||
<p>Tickets that have been closed me then re-opened for a relevant reason. Most likely that the issue has resurfaced or wasn't totally fixed.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Suspended">Suspended</span></h4>
|
||
<h3><span class="mw-headline" id="Ticket_Priority">Ticket Priority</span></h3>
|
||
<h4><span class="mw-headline" id="Immediat.C9.99">Immediatə</span></h4>
|
||
<h4><span class="mw-headline" id="Urgent">Urgent</span></h4>
|
||
<h4><span class="mw-headline" id="High">High</span></h4>
|
||
<h4><span class="mw-headline" id="Normal">Normal</span></h4>
|
||
<h4><span class="mw-headline" id="Low">Low</span></h4>
|
||
<h4><span class="mw-headline" id="None">None</span></h4>
|
||
<h3><span class="mw-headline" id="Ticket_Severity">Ticket Severity</span></h3>
|
||
<h4><span class="mw-headline" id="Block">Block</span></h4>
|
||
<h4><span class="mw-headline" id="Crash">Crash</span></h4>
|
||
<h4><span class="mw-headline" id="Major">Major</span></h4>
|
||
<h4><span class="mw-headline" id="Minor">Minor</span></h4>
|
||
<h4><span class="mw-headline" id="Tweak">Tweak</span></h4>
|
||
<h4><span class="mw-headline" id="Text">Text</span></h4>
|
||
<h4><span class="mw-headline" id="Trivial">Trivial</span></h4>
|
||
<h4><span class="mw-headline" id="Feature">Feature</span></h4>
|
||
<h2><span class="mw-headline" id="Tagging_Tickets">Tagging Tickets</span></h2>
|
||
<p>An important methodology to track tickets by a certain subject/theme/category. It's important that <b>Existing Tags</b> be used to tag issues <b>before</b> new tags are created. If duplicate or superfluous tags are created the bug tracker admin is responsible to remove them and if possible retag said tickets.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Related">Related</span></h2>
|
||
<p><a href="Bugtracker.html" class="mw-redirect" title="Bugtracker">Bugtracker</a>
|
||
</p>
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
</div><div class="printfooter">
|
||
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Bug_Triage&oldid=234617">http://www.freecadweb.org/wiki/index.php?title=Bug_Triage&oldid=234617</a>"</div>
|
||
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
||
</div>
|
||
</div>
|
||
<div id="mw-navigation">
|
||
<h2>Navigation menu</h2>
|
||
|
||
</body></html> |