summaryrefslogtreecommitdiffstats
path: root/docs/sgml/glossary.sgml
blob: 71ba2dd36967dc552d988093a9ef7333c245ae90 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<!-- <!DOCTYPE glossary PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > -->

  <glossary id="glossary">
    <glossdiv>
      <title>0-9, high ascii</title>
      <glossentry>
	<glossterm>.htaccess</glossterm>
	<glossdef>
	  <para>
	    Apache web server, and other NCSA-compliant web servers,
	    observe the convention of using files in directories
	    called <filename>.htaccess</filename> files.  These
	    restrict parameters of the web server.  In Bugzilla, they
	    are used to restrict access to certain files which would
	    otherwise compromise your installation.  For instance, the
	    <filename>localconfig</filename> file contains the
	    password to your database.  If this information were
	    generally available, and remote access to your database
	    turned on, you risk corruption of your database by
	    computer criminals or the curious.
	  </para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_a">
      <title>A</title>
      <glossentry>
	<glossterm>There are no entries for A</glossterm>
	<glossdef>
	  <para></para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_b">
      <title>B</title>
      <glossentry>
	<glossterm>Bug</glossterm>
	<glossdef>
	<para>
	    A <quote>Bug</quote> in Bugzilla refers to an issue
	    entered into the database which has an associated number,
	    assignments, comments, etc. Some also refer to a
	    <quote>tickets</quote> or <quote>issues</quote>; in the
	    context of Bugzilla, they are synonymous.
	  </para>
	</glossdef>
      </glossentry>
      
      <glossentry>
	<glossterm>Bug Number</glossterm>
	<glossdef>
	  <para>
	    Each Bugzilla Bug is assigned a number that uniquely
	    identifies that Bug.  The Bug associated with a Bug Number
	    can be pulled up via a query, or easily from the very
	    front page by typing the number in the "Find" box.
	  </para>
	</glossdef>
      </glossentry>
      
      <glossentry>
	<glossterm>Bug Life Cycle</glossterm>
	<glossdef>
	  <para>A Bug has stages through which it must pass before
	    becoming a <quote>closed bug</quote>, including
	    acceptance, resolution, and verification.  The <quote>Bug
	      Life Cycle</quote> is moderately flexible according to
	    the needs of the organization using it, though.</para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_i">
      <title>I</title>
      <glossentry id="gloss_infiniteloop">
	<glossterm>Infinite Loop</glossterm>
	<glossdef>
	  <para>A loop of information that never ends; see recursion.</para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_p">
      <title>P</title>
      <glossentry>
	<glossterm id="gloss_product">Product</glossterm>
	<glossdef>
	  <para>A Product is a broad category of types of bugs.  In
	    general, there are several Components to a Product.  A
	    Product also defines a default Group (used for Bug
	    Security) for all bugs entered into components beneath
	    it.</para>
	  <example>
	    <title>A Sample Product</title>
	    <para>A company sells a software product called
	      <quote>X</quote>.  They also maintain some older
	      software called <quote>Y</quote>, and have a secret
	      project <quote>Z</quote>.  An effective use of Products
	      might be to create Products <quote>X</quote>,
	      <quote>Y</quote>, <quote>Z</quote>, each with Components
	      of User Interface, Database, and Business Logic.  They
	      might also change group permissions so that only those
	      people who are members of Group <quote>Z</quote> can see
	      components and bugs under Product
	      <quote>Z</quote>.</para>
	  </example>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_q">
      <title>Q</title>
      <glossentry>
	<glossterm>QA</glossterm>
	<glossdef>
	  <para><quote>QA</quote>, <quote>Q/A</quote>, and
	    <quote>Q.A.</quote> are short for <quote>Quality
	      Assurance</quote>.  In most large software development
	    organizations, there is a team devoted to ensuring the
	    product meets minimum standards before shipping.  This
	    team will also generally want to track the progress of
	    bugs over their life cycle, thus the need for the
	    <quote>QA Contact</quote> field in a Bug.</para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_r">
      <title>R</title>
      <glossentry>
	<glossterm id="gloss_recursion">Recursion</glossterm>
	<glossdef>
	  <para>The property of a function looking back at itself for
	    something.  <quote>GNU</quote>, for instance, stands for
	    <quote>GNU's Not UNIX</quote>, thus recursing upon itself
	    for definition.  For further clarity, see Infinite
	    Loop.</para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
    <glossdiv id="gloss_z">
      <title>Z</title>
      <glossentry>
	<glossterm>Zarro Boogs Found</glossterm>
	<glossdef>
	  <para>This is the cryptic response sent by Bugzilla when a
	    query returned no results.  It is just a goofy way of
	    saying "Zero Bugs Found".</para>
	</glossdef>
      </glossentry>
    </glossdiv>
    
  </glossary>
  
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-always-quote-attributes:t
sgml-auto-insert-required-elements:t
sgml-balanced-tag-edit:t
sgml-exposed-tags:nil
sgml-general-insert-case:lower
sgml-indent-data:t
sgml-indent-step:2
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
sgml-minimize-attributes:nil
sgml-namecase-general:t
sgml-omittag:t
sgml-parent-document:("Bugzilla-Guide.sgml" "book" "chapter")
sgml-shorttag:t
sgml-tag-region-if-active:t
End:
-->