trunk/docs/bugs.tex

   1 LibreWRT as a free software project opens its development to the community by
   2 having a publicly browseable subversion repository, a Wiki and a ticket reporting
   3 system is used as an interface between developers, users and contributors in order to
   4 make the whole development process much easier and efficient.
   5
   6 We make distinction between two kinds of people within the Trac system:
   7
   8 \begin{itemize}
   9 \item developers, able to report, close and fix tickets
  10 \item reporters, able to add a comment, patch, or request ticket status
  11 \end{itemize}
  12
  13 \subsubsection{Opening a ticket}
  14
  15 A reporter might want to open a ticket for the following reasons:
  16
  17 \begin{itemize}
  18 \item a bug affects a specific hardware and/or software and needs to be fixed
  19 \item a specific software package would be seen as part of the official LibreWRT repository
  20 \item a feature should be added or removed from LibreWRT
  21 \end{itemize}
  22
  23 Regarding the kind of ticket that is open, a patch is welcome in those cases:
  24
  25 \begin{itemize}
  26 \item new package to be included in LibreWRT
  27 \item fix for a bug that works for the reporter and has no known side effect
  28 \item new features that can be added by modifying existing LibreWRT files
  29 \end{itemize}
  30
  31 Once the ticket is open, a developer will take care of it, if so, the ticket is marked
  32 as "accepted" with the developer name. You can add comments at any time to the ticket,
  33 even when it is closed.
  34
  35 \subsubsection{Closing a ticket}
  36
  37 A ticket might be closed by a developer because:
  38
  39 \begin{itemize}
  40 \item the problem is already fixed (wontfix)
  41 \item the problem described is not judged as valid, and comes along with an explanation why (invalid)
  42 \item the developers know that this bug will be fixed upstream (wontfix)
  43 \item the problem is very similar to something that has already been reported (duplicate)
  44 \item the problem cannot be reproduced by the developers (worksforme)
  45 \end{itemize}
  46
  47 At the same time, the reporter may want to get the ticket closed since he is not
  48 longer able to trigger the bug, or found it invalid by himself.
  49
  50 When a ticket is closed by a developer and marked as "fixed", the comment contains
  51 the subversion changeset which corrects the bug.