editor-manual/chapter05/enternewbugs.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6
   7 <sect1 id="ch05-filingbug">
   8   <title>Enter a new bug</title>
   9   <?dbhtml filename="enternewbug.html"?>
  10
  11   <para>You found a bug, or somebody else found a bug and you decided to add
  12     it to Trac.  Or, you want to log a request for a feature that somebody has
  13     asked for, or a task of some other type.
  14   </para>
  15
  16   <itemizedlist>
  17
  18   <listitem>
  19     <para>Go to <ulink url="http://wiki.linuxfromscratch.org/lfs/newticket"/>
  20     </para>
  21   </listitem>
  22
  23   <listitem><para>Select the ticket type (defect for bugs, or enhancement,
  24     or task). </para>
  25   </listitem>
  26
  27   <listitem><para>The <emphasis>Short summary</emphasis> and <emphasis>
  28     Full Description</emphasis> are mandatory.</para>
  29   </listitem>
  30
  31   <listitem><para>Select the <emphasis>Priority</emphasis>. Use your
  32     own judgement on how important fixing this bug is. If you're not sure just
  33     leave the default. Priorities are periodically re-evaluated and changed
  34     anyway.</para>
  35   </listitem>
  36
  37   <listitem><para>Select the <emphasis>Component</emphasis> - the only
  38     options are Book or Bootscripts.</para>
  39   </listitem>
  40
  41   <listitem><para>Select the <emphasis>Severity</emphasis> as appropriate,
  42     anything from trivial to critical or blocker.</para>
  43   </listitem>
  44
  45   <listitem><para>If you don't want to assign yourself to it right away, leave
  46     the <emphasis>Assign To</emphasis> field blank. It'll be assigned to
  47     <email>lfs-book@linuxfromscratch.org</email> then, until a real editor
  48     changes that to himself.</para>
  49   </listitem>
  50
  51   <listitem><para>If you wish, select a <emphasis>Milestone</emphasis>, either
  52     the next version, or future.</para>
  53   </listitem>
  54
  55   <listitem><para>Select the proper <emphasis>Version</emphasis>. You most
  56     always will choose the <emphasis>SVN</emphasis> version. It doesn't make
  57     sense to report a bug against an old version if it's no longer in Subversion. If it
  58     is, then SVN is newer than a previously released stable book version.  The
  59     versions are basically there only for people who don't edit the book and who
  60     want to report a bug against the book version they have.</para>
  61   </listitem>
  62
  63   <listitem><para>Fill in the <emphasis>Keywords</emphasis> and <emphasis>Cc:
  64     </emphasis> fields if you wish.</para>
  65   </listitem>
  66
  67   <listitem><para>Particularly if you are using any formatting in the Full
  68     description field, you may wish to click on the <emphasis>Preview</emphasis>
  69    button.</para>
  70   </listitem>
  71
  72   <listitem><para>As the last step, click on the <emphasis>Submit ticket</emphasis>
  73     button to commit your changes to the database. A log of this will be sent to
  74     the <email>lfs-book@linuxfromscratch.org</email> mailinglist.</para>
  75   </listitem>
  76 </itemizedlist>
  77
  78 </sect1>
  79