Mercurial > ~dholland > hg > swallowtail > index.cgi
comparison doc/swallowtail.tex @ 19:0365c1ab6fd8
Improve description of classification schemes.
author | David A. Holland |
---|---|
date | Mon, 03 Sep 2012 20:17:20 -0400 |
parents | 2f6e36e87efd |
children | 675b7dd62bba |
comparison
equal
deleted
inserted
replaced
18:2f6e36e87efd | 19:0365c1ab6fd8 |
---|---|
648 \section{Classification Schemes} | 648 \section{Classification Schemes} |
649 | 649 |
650 Here is a quick discussion of the classification schemes that we | 650 Here is a quick discussion of the classification schemes that we |
651 expect to use, or might use. | 651 expect to use, or might use. |
652 | 652 |
653 There are four kinds of classifications: enumerated (the value must be | |
654 one from a fixed set of constants), tags (the value is zero or more | |
655 constants from a fixed pool), text (the value can be any string), and | |
656 hierarchical (like enumerated, but with structure). | |
657 | |
658 In the long run some of the things that are currently PR states may | |
659 want to be tags instead. | |
660 | |
653 \subsection{Enumerated classifications} | 661 \subsection{Enumerated classifications} |
654 | 662 |
655 \paragraph{Category.} | 663 \paragraph{Category.} |
656 The part of the system affected, in broad terms. | 664 The part of the system affected, in broad terms. |
657 The same as the GNATS ``Category'' field. | 665 The same as the GNATS ``Category'' field. |
668 | 676 |
669 \paragraph{Priority.} | 677 \paragraph{Priority.} |
670 | 678 |
671 The GNATS ``Priority'' field. | 679 The GNATS ``Priority'' field. |
672 | 680 |
681 \subsection{Tag sets.} | |
682 | |
683 \paragraph{Release-goals.} | |
684 Tags like \texttt{6-CRITICAL}, to be applied and managed by releng | |
685 when planning for a release. | |
686 | |
687 \paragraph{Branch-notes.} | |
688 Tags like \texttt{5-ONLY}, to mark bugs that do not affect HEAD and | |
689 that can therefore be retired along with branches. | |
690 | |
673 \subsection{Text classifications} | 691 \subsection{Text classifications} |
674 | 692 |
675 \paragraph{Manpage.} | 693 \paragraph{Manpage.} |
676 The name of the nearest man page to where the problem appears to be. | 694 The name of the nearest man page to where the problem appears to be. |
677 FreeBSD has been using this as a tagging scheme for some time. | 695 FreeBSD has been using this as a tagging scheme for some time. |
686 The hierarchical taxonomy I've been using for the buglists web page. | 704 The hierarchical taxonomy I've been using for the buglists web page. |
687 | 705 |
688 \paragraph{Consequences.} | 706 \paragraph{Consequences.} |
689 A hierarchical taxonomy of the results of the problem (annoyance, | 707 A hierarchical taxonomy of the results of the problem (annoyance, |
690 system crash, remote root exploit, etc.) | 708 system crash, remote root exploit, etc.) |
691 | |
692 \subsection{Tag sets.} | |
693 | |
694 \paragraph{Releng.} | |
695 Tags like \texttt{6-CRITICAL}. | |
696 | 709 |
697 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% | 710 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
698 \section{Other Future Features} | 711 \section{Other Future Features} |
699 | 712 |
700 Some other things that aren't likely to be deployed immediately but | 713 Some other things that aren't likely to be deployed immediately but |