Mercurial > ~dholland > hg > swallowtail > index.cgi

comparison doc/swallowtail.tex @ 19:0365c1ab6fd8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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