changeset 19:0365c1ab6fd8

Improve description of classification schemes.
author David A. Holland
date Mon, 03 Sep 2012 20:17:20 -0400
parents 2f6e36e87efd
children 675b7dd62bba
files doc/swallowtail.pdf doc/swallowtail.tex
diffstat 2 files changed, 18 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
Binary file doc/swallowtail.pdf has changed
--- a/doc/swallowtail.tex	Mon Sep 03 19:29:24 2012 -0400
+++ b/doc/swallowtail.tex	Mon Sep 03 20:17:20 2012 -0400
@@ -650,6 +650,14 @@
 Here is a quick discussion of the classification schemes that we
 expect to use, or might use.
 
+There are four kinds of classifications: enumerated (the value must be
+one from a fixed set of constants), tags (the value is zero or more
+constants from a fixed pool), text (the value can be any string), and
+hierarchical (like enumerated, but with structure).
+
+In the long run some of the things that are currently PR states may
+want to be tags instead.
+
 \subsection{Enumerated classifications}
 
 \paragraph{Category.}
@@ -670,6 +678,16 @@
 
 The GNATS ``Priority'' field.
 
+\subsection{Tag sets.}
+
+\paragraph{Release-goals.}
+Tags like \texttt{6-CRITICAL}, to be applied and managed by releng
+when planning for a release.
+
+\paragraph{Branch-notes.}
+Tags like \texttt{5-ONLY}, to mark bugs that do not affect HEAD and
+that can therefore be retired along with branches.
+
 \subsection{Text classifications}
 
 \paragraph{Manpage.}
@@ -689,11 +707,6 @@
 A hierarchical taxonomy of the results of the problem (annoyance,
 system crash, remote root exploit, etc.)
 
-\subsection{Tag sets.}
-
-\paragraph{Releng.}
-Tags like \texttt{6-CRITICAL}.
-
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Other Future Features}