docs/wiki/geda-bug_triage_guide.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html>
   4 <head>
   5   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   6   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   7   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   8
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  10 </head>
  11 <body>
  12
  13 <p>
  14 <em>Translations of this page are also available in the following languages:</em> <a href="geda-bug_triage_guide.ru.html" class="wikilink1" title="geda-bug_triage_guide.ru.html">Русский</a>, <a href="geda-bug_triage_guide.nl.html" class="wikilink1" title="geda-bug_triage_guide.nl.html">Nederlands</a>.
  15 </p>
  16
  17 <h1 class="sectionedit1" id="geda_gaf_and_pcb_bug_feature_request_triage_guide">gEDA/gaf and PCB Bug/Feature Request Triage Guide</h1>
  18 <div class="level1">
  19
  20 <p>
  21 gEDA/gaf and PCB use <a href="http://launchpad.net" class="urlextern" title="http://launchpad.net" rel="nofollow">Launchpad</a> for bug and feature request tracking - the gEDA landing page is <a href="http://bugs.launchpad.net/geda" class="urlextern" title="http://bugs.launchpad.net/geda" rel="nofollow"> here</a> and the PCB landing page is <a href="http://bugs.launchpad.net/pcb" class="urlextern" title="http://bugs.launchpad.net/pcb" rel="nofollow"> here</a>.
  22 </p>
  23
  24 <p>
  25 Newly filed bugs and feature requests must be triaged periodically by the developers and others close to the project, in order to progress them smoothly through development and avoid them getting stuck.
  26 </p>
  27
  28 <p>
  29 Anyone who wants to help triage bugs for the community, please apply to
  30 join the geda-bugs team for <a href="https://launchpad.net/~geda-bugs/+join" class="urlextern" title="https://launchpad.net/~geda-bugs/+join" rel="nofollow">gEDA/gaf</a> and/or <a href="https://launchpad.net/~pcb-bugs/+join" class="urlextern" title="https://launchpad.net/~pcb-bugs/+join" rel="nofollow">PCB</a>.
  31 </p>
  32
  33 </div>
  34 <!-- EDIT1 SECTION "gEDA/gaf and PCB Bug/Feature Request Triage Guide" [155-863] -->
  35 <h2 class="sectionedit2" id="triaging_bugs">Triaging bugs</h2>
  36 <div class="level2">
  37 <ol>
  38 <li class="level1 node"><div class="li"> Choose a bug from</div>
  39 <ul>
  40 <li class="level2"><div class="li"> <a href="https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New" class="urlextern" title="https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New" rel="nofollow">https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New</a></div>
  41 </li>
  42 <li class="level2"><div class="li"> <a href="https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New" class="urlextern" title="https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New" rel="nofollow">https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New</a></div>
  43 </li>
  44 </ul>
  45 </li>
  46 <li class="level1"><div class="li"> Grab “git HEAD” of whichever package the bug is in (if you don&#039;t have it already) and try to confirm whether the bug is still present or not. (<a href="http://git.geda-project.org" class="urlextern" title="http://git.geda-project.org" rel="nofollow">http://git.geda-project.org</a>)</div>
  47 </li>
  48 <li class="level1 node"><div class="li"> If the bug is still present, move the status from “New” to “Confirmed”</div>
  49 <ul>
  50 <li class="level2"><div class="li"> If and only if there is a good testcase uploaded that reproduces the bug (or you have created and uploaded one as part of triage), you can move the status to “Triaged”</div>
  51 </li>
  52 <li class="level2"><div class="li">  <em><strong>Note:</strong> it is not good form to mark your own bug “Confirmed”.</em></div>
  53 </li>
  54 </ul>
  55 </li>
  56 <li class="level1 node"><div class="li"> If the bug is absent, make a comment and set the status to one of</div>
  57 <ul>
  58 <li class="level2 node"><div class="li"> “Invalid”, if you are confident that the bug is bogus or misfiled.</div>
  59 <ul>
  60 <li class="level3"><div class="li"> If the bug is tagged with “sf-patches” shouldn&#039;t be closed “Invalid”. If the patch cannot or will not be accepted, mark it as “WontFix”.</div>
  61 </li>
  62 </ul>
  63 </li>
  64 <li class="level2"><div class="li"> “Fix Committed”, if you believe a fix has been committed in git since the last release;</div>
  65 </li>
  66 <li class="level2"><div class="li"> “Fix Released”, if you believe a fix has been committed that has been in a released version;</div>
  67 </li>
  68 <li class="level2"><div class="li"> “Incomplete”, if you ask the reporter a question which needs to be answered to properly assess the bug.</div>
  69 </li>
  70 </ul>
  71 </li>
  72 <li class="level1"><div class="li"> If the bug affects you personally, hit the link under the title of the bug that lets you state that.</div>
  73 </li>
  74 <li class="level1"><div class="li"> If you want to be emailed when the bug is modified, click “Subscribe” on the right hand toolbar.</div>
  75 </li>
  76 </ol>
  77
  78 </div>
  79 <!-- EDIT2 SECTION "Triaging bugs" [864-2349] -->
  80 <h2 class="sectionedit3" id="triaging_feature_requests">Triaging Feature Requests</h2>
  81 <div class="level2">
  82
  83 <p>
  84 <em>There are two active feature request lists (02-2016):</em>
  85 </p>
  86 <ul>
  87 <li class="level1 node"><div class="li"> Launch Pad:</div>
  88 <ol>
  89 <li class="level2 node"><div class="li"> Choose a feature request from</div>
  90 <ul>
  91 <li class="level3"><div class="li"> <a href="https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New" class="urlextern" title="https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New" rel="nofollow">https://launchpad.net/geda/+bugs?search=Search&amp;field.status=New</a></div>
  92 </li>
  93 <li class="level3"><div class="li"> <a href="https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New" class="urlextern" title="https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New" rel="nofollow">https://launchpad.net/pcb/+bugs?search=Search&amp;field.status=New</a></div>
  94 </li>
  95 </ul>
  96 </li>
  97 <li class="level2"><div class="li"> If it&#039;s not already set, set the Importance to “Wishlist”</div>
  98 </li>
  99 <li class="level2"><div class="li"> If you agree with the feature request, select the “Bug affects me” option. This will allow us to track the popularity of a request.</div>
 100 </li>
 101 <li class="level2"><div class="li"> A developer who is sufficiently familiar with the design issues will move the Status from “New” to either “Confirmed”, “WontFix” or “Opinion”.</div>
 102 </li>
 103 </ol>
 104 </li>
 105 <li class="level1 node"><div class="li"> Geda/PCB Project Wiki:</div>
 106 <ol>
 107 <li class="level2 node"><div class="li"> “Wish List” at the bottom of this page:</div>
 108 <ul>
 109 <li class="level3"><div class="li"> <a href="http://wiki.geda-project.org/pcb:roadmap" class="urlextern" title="http://wiki.geda-project.org/pcb:roadmap" rel="nofollow">http://wiki.geda-project.org/pcb:roadmap</a></div>
 110 </li>
 111 </ul>
 112 </li>
 113 </ol>
 114 </li>
 115 </ul>
 116
 117 </div>
 118 <!-- EDIT3 SECTION "Triaging Feature Requests" [2350-] --></body>
 119 </html>