Bug 170213 - make static HTML files into page.cgi pages. This does votehelp.html (-> id=voting.html), bug_status.html (-> id=fields.html) and bugwritinghelp.html (-> id=bug-writing.html). Patch by gerv; r=kiko, a=justdave.

This commit is contained in:
gerv%gerv.net 2004-03-07 23:27:32 +00:00
Родитель 1e5e003141
Коммит 93df2945c9
11 изменённых файлов: 749 добавлений и 25 удалений

Просмотреть файл

@ -137,7 +137,7 @@ sub EmitFormElements ($$$$$$$$)
print " <TD><INPUT SIZE=5 MAXLENGTH=5 NAME=\"maxvotesperbug\" VALUE=\"$maxvotesperbug\"></TD>\n";
print "</TR><TR>\n";
print " <TH ALIGN=\"right\">Number of votes a bug in this product needs to automatically get out of the <A HREF=\"bug_status.html#status\">UNCONFIRMED</A> state:</TH>\n";
print " <TH ALIGN=\"right\">Number of votes a bug in this product needs to automatically get out of the <A HREF=\"page.cgi?id=fields.html#status\">UNCONFIRMED</A> state:</TH>\n";
print " <TD><INPUT SIZE=5 MAXLENGTH=5 NAME=\"votestoconfirm\" VALUE=\"$votestoconfirm\"></TD>\n";
}

Просмотреть файл

@ -79,7 +79,7 @@ for access speed):
<td rowspan="2"><tt>UNCO,NEW,...,CLOS,<br>FIX,DUP,...<i>(as first word)</i></tt></td>
<td><tt>status</tt></td>
<td>&nbsp;</td>
<td><a href="bug_status.html">Status</a>
<td><a href="page.cgi?id=fields.html#status">Status</a>
<i>("bug_status")</i>
</td>
</tr>
@ -87,35 +87,35 @@ for access speed):
<td>&nbsp;</td>
<td><tt>resolution</tt></td>
<td>&nbsp;</td>
<td><a href="bug_status.html">Resolution</a></td>
<td><a href="page.cgi?id=fields.html#resolution">Resolution</a></td>
</tr>
<tr>
<td>&nbsp;</td>
<td><i>as-is</i></td>
<td><tt>platform</tt></td>
<td>&nbsp;</td>
<td><a href="bug_status.html#rep_platform">Platform</a> <i>("rep_platform")</i></td>
<td><a href="page.cgi?id=fields.html#rep_platform">Platform</a> <i>("rep_platform")</i></td>
</tr>
<tr>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td><tt>os</tt></td>
<td><tt>opsys</tt></td>
<td><a href="bug_status.html#op_sys">OS</a> <i>("op_sys")</i></td>
<td><a href="page.cgi?id=fields.html#op_sys">OS</a> <i>("op_sys")</i></td>
</tr>
<tr>
<td>&nbsp;</td>
<td><tt>p1,p2</tt> <i>or</i> <tt>p1-2</tt></td>
<td><tt>priority</tt></td>
<td><tt>pri</tt></td>
<td><a href="bug_status.html#priority">Priority</a></td>
<td><a href="page.cgi?id=fields.html#priority">Priority</a></td>
</tr>
<tr>
<td>&nbsp;</td>
<td><tt>blo,cri,...,enh</tt></td>
<td><tt>severity</tt></td>
<td><tt>sev</tt></td>
<td><a href="bug_status.html#severity">Severity</a> <i>("bug_severity")</i></td>
<td><a href="page.cgi?id=fields.html#bug_severity">Severity</a> <i>("bug_severity")</i></td>
</tr>
<!-- People: AssignedTo, Reporter, QA Contact, CC, Added comment -->
@ -126,7 +126,7 @@ for access speed):
<td><b>@</b><i>owner</i></td>
<td><tt>assignedto</tt></td>
<td><tt>assignee, owner</tt></td>
<td><a href="bug_status.html#assigned_to">Assignee</a> <i>("assigned_to")</i></td>
<td><a href="page.cgi?id=fields.html#assigned_to">Assignee</a> <i>("assigned_to")</i></td>
</tr>
<tr>
<td>&nbsp;</td>

Просмотреть файл

@ -176,7 +176,7 @@ function set_assign_to() {
<tr>
<td align="right">
<strong>
<a href="bug_status.html#assigned_to">Assign To</a>:
<a href="page.cgi?id=fields.html#assigned_to">Assign To</a>:
</strong>
</td>
<td colspan="3">
@ -333,7 +333,8 @@ function set_assign_to() {
[% IF sel.description %]
<td align="right">
<strong>
<a href="bug_status.html#[% sel.name %]">[% sel.description %]</a>:
<a href="page.cgi?id=fields.html#[% sel.name %]">
[% sel.description %]</a>:
</strong>
</td>
[% END %]

Просмотреть файл

@ -30,7 +30,8 @@
[% PROCESS global/variables.none.tmpl %]
Before reporting [% terms.abug %], please read the <a href="bugwritinghelp.html">
Before reporting [% terms.abug %], please read the
<a href="page.cgi?id=bug-writing.html">
[% terms.bug %] writing guidelines</a>, please look at the list of
<a href="duplicates.cgi">most frequently reported [% terms.bugs %]</a>, and please
<a href="query.cgi">search</a> for the [% terms.bug %].

Просмотреть файл

@ -205,14 +205,14 @@
<tr>
<td align="right">
<b>
<a href="bug_status.html">Status</a>:
<a href="page.cgi?id=fields.html#status">Status</a>:
</b>
</td>
<td>[% bug.bug_status FILTER html %]</td>
<td>&nbsp;</td>
<td align="right">
<b><a href="bug_status.html#priority">Pr<u>i</u>ority</a>:</b>
<b><a href="page.cgi?id=fields.html#priority">Pr<u>i</u>ority</a>:</b>
</td>
[% PROCESS select selname => "priority" accesskey => "i" %]
</tr>
@ -220,7 +220,7 @@
<tr>
<td align="right">
<b>
<a href="bug_status.html">Resolution</a>:
<a href="page.cgi?id=fields.html#resolution">Resolution</a>:
</b>
</td>
<td>
@ -232,7 +232,7 @@
<td>&nbsp;</td>
<td align="right">
<b><a href="bug_status.html#severity">S<u>e</u>verity</a>:</b>
<b><a href="page.cgi?id=fields.html#severity">S<u>e</u>verity</a>:</b>
</td>
[% PROCESS select selname = "bug_severity" accesskey => "e" %]
@ -241,7 +241,7 @@
<tr>
<td align="right">
<b>
<a href="bug_status.html#assigned_to">Assigned&nbsp;To</a>:
<a href="page.cgi?id=fields.html#assigned_to">Assigned&nbsp;To</a>:
</b>
</td>
<td>[% bug.assigned_to.identity FILTER html %]</td>
@ -428,7 +428,7 @@
<table>
<tr>
<th>
<a href="votehelp.html">Votes</a>:
<a href="page.cgi?id=voting.html">Votes</a>:
</th>
<td>
[% bug.votes %]&nbsp;&nbsp;&nbsp;

Просмотреть файл

@ -59,7 +59,8 @@
[% END %]
<input type="radio" name="knob" value="resolve">
Resolve [% terms.bug %], changing <a href="bug_status.html">resolution</a> to
Resolve [% terms.bug %], changing
<a href="page.cgi?id=fields.html#resolution">resolution</a> to
<select name="resolution"
onchange="document.changeform.knob[[% knum %]].checked=true">
[% FOREACH r = bug.choices.resolution %]
@ -78,7 +79,8 @@
[% knum = knum + 1 %]
<input type="radio" name="knob" value="reassign">
<a href="bug_status.html#assigned_to">Reassign</a> [% terms.bug %] to
<a href="page.cgi?id=fields.html#assigned_to">Reassign</a>
[% terms.bug %] to
<input name="assigned_to" size="32"
onchange="if ((this.value != '[% bug.assigned_to.email FILTER js %]') &&
(this.value != '')) {

Просмотреть файл

@ -141,7 +141,7 @@
[% END %]
<p>
<a href="votehelp.html">Help with voting</a>.
<a href="page.cgi?id=voting.html">Help with voting</a>.
</p>
[% PROCESS global/footer.html.tmpl %]

Просмотреть файл

@ -70,7 +70,7 @@
<th>
<label for="rep_platform">
<a href="bug_status.html#rep_platform">Platform</a>:
<a href="page.cgi?id=fields.html#rep_platform">Platform</a>:
</label>
</th>
<td>
@ -80,7 +80,7 @@
<th>
<label for="priority">
<a href="bug_status.html#priority">Priority</a>:
<a href="page.cgi?id=fields.html#priority">Priority</a>:
</label>
</th>
<td>
@ -99,7 +99,7 @@
<th>
<label for="bug_severity">
<a href="bug_status.html#severity">Severity</a>:
<a href="page.cgi?id=fields.html#severity">Severity</a>:
</label>
</th>
<td>
@ -266,7 +266,7 @@
[% knum = knum + 1 %]
<input id="knob-resolve" type="radio" name="knob" value="resolve">
<label for="knob-resolve">
Resolve [% terms.bugs %], changing <a href="bug_status.html">resolution</a> to
Resolve [% terms.bugs %], changing <a href="page.cgi?id=fields.html#resolution">resolution</a> to
</label>
<select name="resolution" onchange="document.forms.changeform.knob[[% knum %]].checked=true">
[% FOREACH resolution = resolutions %]
@ -300,7 +300,7 @@
[% knum = knum + 1 %]
<input id="knob-reassign" type="radio" name="knob" value="reassign">
<label for="knob-reassign"><a href="bug_status.html#assigned_to">
<label for="knob-reassign"><a href="page.cgi?id=fields.html#assigned_to">
Reassign</a> [% terms.bugs %] to
</label>
<input name="assigned_to"

Просмотреть файл

@ -0,0 +1,390 @@
[%# 1.0@bugzilla.org %]
[%# The contents of this file are subject to the Mozilla Public
# License Version 1.1 (the "License"); you may not use this file
# except in compliance with the License. You may obtain a copy of
# the License at http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS
# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
# implied. See the License for the specific language governing
# rights and limitations under the License.
#
# The Original Code is the Bugzilla Bug Tracking System.
#
# The Initial Developer of the Original Code is Netscape Communications
# Corporation. Portions created by Netscape are
# Copyright (C) 1998 Netscape Communications Corporation. All
# Rights Reserved.
#
# Contributor(s): Eli Goldberg <eli@prometheus-music.com>
# Gervase Markham <gerv@gerv.net>
# Claudius Gayle
# Peter Mock
# Chris Pratt
# Tom Schutter
# Chris Yeh
#%]
[% PROCESS global/variables.none.tmpl %]
[% INCLUDE global/header.html.tmpl title = "$terms.Bug Writing Guidelines" %]
<h3>Why You Should Read This</h3>
<blockquote>
<p>Simply put, the more effectively you report a [% terms.bug %], the more
likely an
engineer will actually fix it.</p>
<p>These guidelines are a general tutorial to teach novice and
intermediate [% terms.bug %] reporters how to compose effective
[% terms.bug %] reports. Not
every sentence may precisely apply to your software project.</p>
</blockquote>
<h3>How to Write a Useful [% terms.Bug %] Report</h3>
<blockquote>
<p>Useful [% terms.bug %] reports are ones that get [% terms.bugs %] fixed.
A useful [% terms.bug %] report normally has two qualities:</p>
<ol>
<li><b>Reproducible.</b> If an engineer can't see the [% terms.bug %]
herself to prove that it exists, she'll probably stamp your [% terms.bug %]
report "WORKSFORME" or "INVALID" and move on to the next [% terms.bug %].
Every detail you can provide helps.<br>
<br>
</li>
<li><b>Specific.</b> The quicker the engineer can isolate the
[% terms.bug %] to a specific area, the more likely she'll expediently
fix it. (If a programmer or tester has to decypher a [% terms.bug %],
they may spend more time cursing the submitter than solving the
problem.)<br>
<br>
[ <a href="#tips" name="Anchor">Tell Me More</a> ]</li>
</ol>
<p>Let's say the application you're testing is a web browser. You crash
at foo.com, and want to write up a [% terms.bug %] report:</p>
<blockquote>
<p><b>BAD:</b> "My browser crashed. I think I was on www.foo.com. I
play golf with Bill Gates, so you better fix this problem, or I'll
report you to him. By the way, your Back icon looks like a squashed
rodent. UGGGLY. And my grandmother's home page is all messed up in your
browser. Thx 4 UR help."</p>
<p><b>GOOD:</b> "I crashed each time I went to www.foo.com, using the
2002-02-25 build on a Windows 2000 system. I also rebooted into Linux,
and reproduced this problem using the 2002-02-24 Linux build.</p>
<p>It again crashed each time upon drawing the Foo banner at the top of
the page. I broke apart the page, and discovered that the following
image link will crash the application reproducibly, unless you remove
the "border=0" attribute:</p>
<p><tt>&lt;IMG SRC="http://www.foo.com/images/topics/topicfoos.gif"
width="34" height="44" border="0" alt="News"&gt;</tt></p>
</blockquote>
</blockquote>
<h3>How to Enter your Useful [% terms.Bug %] Report
into [% terms.Bugzilla %]:</h3>
<blockquote>
<p>Before you enter your [% terms.bug %], use [% terms.Bugzilla %]'s
<a href="query.cgi">search page</a> to determine whether the defect
you've discovered is a known, already-reported [% terms.bug %]. If
your [% terms.bug %] is the 37th duplicate of a known issue,
you're more likely to annoy the engineer. (Annoyed engineers fix fewer
[% terms.bugs %].)</p>
<p>Next, be sure to reproduce your [% terms.bug %] using a recent build.
Engineers tend to be most interested in problems affecting the code base
that they're actively working on. After all, the [% terms.bug %] you're
reporting may already be fixed.</p>
<p>If you've discovered a new [% terms.bug %] using a current build, report
it in [% terms.Bugzilla %]:</p>
<ol>
<li>From your [% terms.Bugzilla %] main page, choose
"<a href="enter_bug.cgi">Enter a new [% terms.bug %]</a>".</li>
<li>Select the product that you've found a [% terms.bug %] in.</li>
<li>Enter your e-mail address, password, and press the "Login" button.
(If you don't yet have a password, leave the password field empty, and
press the "E-mail me a password" button instead. You'll quickly receive
an e-mail message with your password.)</li>
</ol>
<p>Now, fill out the form. Here's what it all means:</p>
<p><b>Where did you find the [% terms.bug %]?</b></p>
<blockquote>
<p><b>Product: In which product did you find the [% terms.bug %]?</b><br>
You just specified this on the last page, so you can't edit it
here.</p>
<p><b>Version: In which product version did you find
the [% terms.bug %]?</b><br>
(If applicable)</p>
<p><b>Component: In which component does the [% terms.bug %]
exist?</b><br>
[% terms.Bugzilla %] requires that you select a component to enter
a [% terms.bug %]. (Not sure which to choose? Click on the Component link.
You'll see a description of each component, to help you make the best
choice.)</p>
<p><b>OS: On which Operating System (OS) did you find
this [% terms.bug %]?</b>
(e.g. Linux, Windows 2000, Mac OS 9.)<br>
If you know the [% terms.bug %] happens on all OSs, choose 'All'.
Otherwise, select the OS that you found the [% terms.bug %] on, or
"Other" if your OS isn't listed.</p>
</blockquote>
<p><b>How important is the [% terms.bug %]?</b></p>
<blockquote>
<p><b>Severity: How damaging is the [% terms.bug %]?</b><br>
This item defaults to 'normal'. If you're not sure what severity your
[% terms.bug %] deserves, click on the Severity link. You'll see a
description of each severity rating.<br>
</p>
</blockquote>
<p><b>Who will be following up on the [% terms.bug %]?</b></p>
<blockquote>
<p><b>Assigned To: Which engineer should be responsible for fixing
this [% terms.bug %]?</b><br>
[% terms.Bugzilla %] will automatically assign the [% terms.bug %] to a
default engineer upon submitting a [% terms.bug %] report. If you'd prefer
to directly assign the [% terms.bug %] to someone else, enter their e-mail
address into this field. (To see the list of default engineers for each
component, click on the Component link.)</p>
<p><b>Cc: Who else should receive e-mail updates on changes to this
[% terms.bug %]?</b><br>
List the full e-mail addresses of other individuals who should receive
an e-mail update upon every change to the [% terms.bug %] report. You can
enter as many e-mail addresses as you'd like, separated by spaces or
commas, as long as those people have [% terms.Bugzilla %] accounts.</p>
</blockquote>
<p><b>What else can you tell the engineer about the [% terms.bug %]?</b></p>
<blockquote>
<p><b>Summary:</b> <b>How would you describe the [% terms.bug %], in
approximately 60 or fewer characters?</b><br>
A good summary should <b>quickly and uniquely identify a [% terms.bug %]
report</b>. Otherwise, an engineer cannot meaningfully identify your
[% terms.bug %] by its summary, and will often fail to pay attention to
your [% terms.bug %] report when skimming through a 10
page [% terms.bug %] list.<br>
<br>
A useful summary might be "<tt>PCMCIA install fails on Tosh Tecra
780DVD w/ 3c589C</tt>". "<tt>Software fails</tt>" or "<tt>install
problem</tt>" would be examples of a bad summary.<br>
<br>
[ <a href="#summary">Tell Me More</a> ]<br>
<br>
<b>Description:</b><br>
Please provide a detailed problem report in this field. Your
[% terms.bug %]'s recipients will most likely expect the following
information:</p>
<blockquote>
<p><b>Overview Description:</b> More detailed expansion of
summary.</p>
<blockquote>
<pre>
Drag-selecting any page crashes Mac builds in NSGetFactory
</pre>
</blockquote>
<p><b>Steps to Reproduce:</b> Minimized, easy-to-follow steps that
will trigger the [% terms.bug %]. Include any special setup steps.</p>
<blockquote>
<pre>
1) View any web page. (I used the default sample page,
resource:/res/samples/test0.html)
2) Drag-select the page. (Specifically, while holding down
the mouse button, drag the mouse pointer downwards from any
point in the browser's content region to the bottom of the
browser's content region.)
</pre>
</blockquote>
<p><b>Actual Results:</b> What the application did after performing
the above steps.</p>
<blockquote>
<pre>
The application crashed. Stack crawl appended below from MacsBug.
</pre>
</blockquote>
<p><b>Expected Results:</b> What the application should have done,
were the [% terms.bug %] not present.</p>
<blockquote>
<pre>
The window should scroll downwards. Scrolled content should be selected.
(Or, at least, the application should not crash.)
</pre>
</blockquote>
<p><b>Build Date &amp; Platform:</b> Date and platform of the build
that you first encountered the [% terms.bug %] in.</p>
<blockquote>
<pre>
Build 2002-03-15 on Mac OS 9.0
</pre>
</blockquote>
<p><b>Additional Builds and Platforms:</b> Whether or not
the [% terms.bug %] takes place on other platforms (or browsers,
if applicable).</p>
<blockquote>
<pre>
- Also Occurs On
Mozilla (2002-03-15 build on Windows NT 4.0)
- Doesn't Occur On
Mozilla (2002-03-15 build on Red Hat Linux; feature not supported)
Internet Explorer 5.0 (shipping build on Windows NT 4.0)
Netscape Communicator 4.5 (shipping build on Mac OS 9.0)
</pre>
</blockquote>
<p><b>Additional Information:</b> Any other debugging information.
For crashing [% terms.bugs %]:</p>
<ul>
<li><b>Win32:</b> if you receive a Dr. Watson error, please note
the type of the crash, and the module that the application crashed
in. (e.g. access violation in apprunner.exe)</li>
<li><b>Mac OS:</b> if you're running MacsBug, please provide the
results of a <b>how</b> and an <b>sc</b>:</li>
</ul>
<blockquote>
<pre>
*** MACSBUG STACK CRAWL OF CRASH (Mac OS)
Calling chain using A6/R1 links
Back chain ISA Caller
00000000 PPC 0BA85E74
03AEFD80 PPC 0B742248
03AEFD30 PPC 0B50FDDC NSGetFactory+027FC
PowerPC unmapped memory exception at 0B512BD0 NSGetFactory+055F0
</pre>
</blockquote>
</blockquote>
</blockquote>
<p>You're done!<br>
<br>
After double-checking your entries for any possible errors, press the
"Commit" button, and your [% terms.bug %] report will now be in
the [% terms.Bugzilla %] database.<br>
</p>
</blockquote>
<hr>
<h3>More Information on Writing Good [% terms.Bugs %]</h3>
<blockquote>
<p><b><a name="tips"></a> 1. General Tips for a Useful [% terms.Bug %]
Report</b></p>
<blockquote>
<p><b>Use an explicit structure, so your [% terms.bug %] reports are easy
to skim.</b> [% terms.Bug %] report users often need immediate access to
specific sections of your [% terms.bug %]. If your [% terms.Bugzilla %]
installation supports the [% terms.Bugzilla %] Helper, use it.</p>
<p><b>Avoid cuteness if it costs clarity.</b> Nobody will be laughing
at your funny [% terms.bug %] title at 3:00 AM when they can't remember how
to find your [% terms.bug %].</p>
<p><b>One [% terms.bug %] per report.</b> Completely different people
typically fix, verify, and prioritize different [% terms.bugs %]. If you
mix a handful of [% terms.bugs %] into a single report, the right people
probably won't discover your [% terms.bugs %] in a timely fashion, or at
all. Certain [% terms.bugs %] are also more important than others. It's
impossible to prioritize a [% terms.bug %] report when
it contains four different issues, all of differing importance.</p>
<p><b>No [% terms.bug %] is too trivial to report.</b> Unless you're
reading the source code, you can't see actual software [% terms.bugs %],
like a dangling pointer -- you'll see their visible manifestations, such
as the segfault when the application finally crashes. Severe software
problems can manifest themselves in superficially trivial ways. File them
anyway.<br>
</p>
</blockquote>
<p><b><a name="summary"></a>2. How and Why to Write Good [% terms.Bug %]
Summaries</b></p>
<blockquote>
<p><b>You want to make a good first impression on the [% terms.bug %]
recipient.</b> Just like a New York Times headline guides readers
towards a relevant article from dozens of choices, will
your [% terms.bug %] summary suggest that your [% terms.bug %] report is
worth reading from dozens or hundreds of choices?</p>
<p>Conversely, a vague [% terms.bug %] summary like <tt>install
problem</tt> forces anyone reviewing installation [% terms.bugs %] to waste
time opening up your [% terms.bug %] to determine whether it matters.</p>
<p><b>Your [% terms.bug %] will often be searched by its summary.</b> Just
as you'd find web pages with Google by searching by keywords through
intuition, so will other people locate your [% terms.bugs %].
Descriptive [% terms.bug %] summaries are
naturally keyword-rich, and easier to find.</p>
<p>For example, you'll find a [% terms.bug %] titled "<tt>Dragging icons
from List View to gnome-terminal doesn't paste path</tt>" if you search on
"List", "terminal", or "path". Those search keywords wouldn't have
found a [% terms.bug %] titled "<tt>Dragging icons doesn't paste</tt>".</p>
<p>Ask yourself, "Would someone understand my [% terms.bug %] from just
this summary?" If so, you've written a fine summary.</p>
<p><b>Don't write titles like these:</b></p>
<ol>
<li>"Can't install" - Why can't you install? What happens when you
try to install?</li>
<li>"Severe Performance Problems" - ...and they occur when you do
what?</li>
<li>"back button does not work" - Ever? At all?</li>
</ol>
<p><b>Good [% terms.bug %] titles:</b></p>
<ol>
<li>"1.0 upgrade installation fails if Mozilla M18 package present" -
Explains problem and the context.</li>
<li>"RPM 4 installer crashes if launched on Red Hat 6.2 (RPM 3)
system" - Explains what happens, and the context.</li>
</ol>
</blockquote>
</blockquote>
[% INCLUDE global/footer.html.tmpl %]

Просмотреть файл

@ -0,0 +1,265 @@
[%# 1.0@bugzilla.org %]
[%# The contents of this file are subject to the Mozilla Public
# License Version 1.1 (the "License"); you may not use this file
# except in compliance with the License. You may obtain a copy of
# the License at http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS
# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
# implied. See the License for the specific language governing
# rights and limitations under the License.
#
# The Original Code is the Bugzilla Bug Tracking System.
#
# The Initial Developer of the Original Code is Netscape Communications
# Corporation. Portions created by Netscape are
# Copyright (C) 1998 Netscape Communications Corporation. All
# Rights Reserved.
#
# Contributor(s): Terry Weissman <terry@mozilla.org>
# Gervase Markham <gerv@gerv.net>
#%]
[% PROCESS global/variables.none.tmpl %]
[% INCLUDE global/header.html.tmpl title = "A $terms.Bug's Life Cycle" %]
<p>
The <b>status</b> and <b>resolution</b> fields define and track the life
cycle of a [% terms.bug %].
</p>
<a name="status"></a>
<a name="resolution"></a>
<table border="1" cellpadding="4">
<tr align="center" valign="top">
<td width="50%">
<h1>STATUS</h1>
</td>
<td>
<h1>RESOLUTION</h1>
</td>
</tr>
<tr valign="top">
<td>The <b>status</b> field indicates the general health of a
[% terms.bug %]. Only certain status transitions are allowed.</td>
<td>The <b>resolution</b> field indicates what happened to this
[% terms.bug %].</td>
</tr>
<tr valign="top">
<td>
<dl>
<dt><b>UNCONFIRMED</b></dt>
<dd>This [% terms.bug %] has recently been added to the database.
Nobody has validated that this [% terms.bug %] is true. Users who have
the "canconfirm" permission set may confirm this [% terms.bug %],
changing its state to NEW. Or, it may be directly resolved and marked
RESOLVED.</dd>
<dt><b>NEW</b></dt>
<dd>This [% terms.bug %] has recently been added to the assignee's list
of [% terms.bugs %] and must be processed. [% terms.Bugs %] in this
state may be accepted, and become <b>ASSIGNED</b>, passed on to someone
else, and remain <b>NEW</b>, or resolved and marked <b>RESOLVED</b>.
</dd>
<dt><b>ASSIGNED</b></dt>
<dd>This [% terms.bug %] is not yet resolved, but is assigned to the
proper person. From here [% terms.bugs %] can be given to another
person and become <b>NEW</b>, or resolved and become <b>RESOLVED</b>.
</dd>
<dt><b>REOPENED</b></dt>
<dd>This [% terms.bug %] was once resolved, but the resolution was
deemed incorrect. For example, a <b>WORKSFORME</b> [% terms.bug %] is
<b>REOPENED</b> when more information shows up and the [% terms.bug %]
is now reproducible. From here [% terms.bugs %] are either marked
<b>ASSIGNED</b> or <b>RESOLVED</b>.</dd>
</dl>
</td>
<td>
<dl>
<dd>No resolution yet. All [% terms.bugs %] which are in one of
these "open" states have the resolution set to blank. All
other [% terms.bugs %] will be marked with one of the following
resolutions.</dd>
</dl>
</td>
</tr>
<tr valign="top">
<td>
<dl>
<dt><b>RESOLVED</b></dt>
<dd>A resolution has been taken, and it is awaiting verification by
QA. From here [% terms.bugs %] are either re-opened and become
<b>REOPENED</b>, are marked <b>VERIFIED</b>, or are closed for good
and marked <b>CLOSED</b>.</dd>
<dt><b>VERIFIED</b></dt>
<dd>QA has looked at the [% terms.bug %] and the resolution and
agrees that the appropriate resolution has been taken. [% terms.Bugs %]
remain in this state until the product they were reported against
actually ships, at which point they become <b>CLOSED</b>.</dd>
<dt><b>CLOSED</b></dt>
<dd>The [% terms.bug %] is considered dead, the resolution is correct.
Any zombie [% terms.bugs %] who choose to walk the earth again must
do so by becoming <b>REOPENED</b>.</dd>
</dl>
</td>
<td>
<dl>
<dt><b>FIXED</b></dt>
<dd>A fix for this [% terms.bug %] is checked into the tree and
tested.</dd>
<dt><b>INVALID</b></dt>
<dd>The problem described is not a [% terms.bug %]</dd>
<dt><b>WONTFIX</b></dt>
<dd>The problem described is a [% terms.bug %] which will never be
fixed.</dd>
<dt><b>DUPLICATE</b></dt>
<dd>The problem is a duplicate of an existing [% terms.bug %]. Marking
a [% terms.bug %] duplicate requires the [% terms.bug %]# of the
duplicating [% terms.bug %] and will at least put that [% terms.bug %]
number in the description field.</dd>
<dt><b>WORKSFORME</b></dt>
<dd>All attempts at reproducing this [% terms.bug %] were futile,
reading the code produces no clues as to why this behavior would occur.
If more information appears later, please re-assign
the [% terms.bug %], for now, file it.</dd>
<dt><b>MOVED</b></dt>
<dd>The problem was specific to a related product
whose [% terms.bugs %] are tracked in another [% terms.bug %] database.
The [% terms.bug %] has been moved to that database.</dd>
</dl>
</td>
</tr>
</table>
<h2><a name="bug_severity">Severity</a></h2>
This field describes the impact of a [% terms.bug %].
<table>
<tr>
<th>Blocker</th>
<td>Blocks development and/or testing work</td>
</tr>
<tr>
<th>Critical</th>
<td>crashes, loss of data, severe memory leak</td>
</tr>
<tr>
<th>Major</th>
<td>major loss of function</td>
</tr>
<tr>
<th>Minor</th>
<td>minor loss of function, or other problem where easy
workaround is present</td>
</tr>
<tr>
<th>Trivial</th>
<td>cosmetic problem like misspelled words or misaligned
text</td>
</tr>
<tr>
<th>Enhancement</th>
<td>Request for enhancement</td>
</table>
<h2><a name="priority">Priority</a></h2>
This field describes the importance and order in which a [% terms.bug %]
should be fixed. This field is utilized by the
programmers/engineers to prioritize their work to be done. The
available priorities range from <b>P1</b> (most important) to
<b>P5</b> (least important.)
<h2><a name="rep_platform">Platform</a></h2>
This is the hardware platform against which the [% terms.bug %] was
reported. Legal platforms include:
<ul>
<li>All (happens on all platforms; cross-platform [% terms.bug %])</li>
<li>Macintosh</li>
<li>PC</li>
<li>Sun</li>
<li>HP</li>
</ul>
<b>Note:</b> When searching, selecting the option "All" does not
select [% terms.bugs %]
assigned against any platform. It merely selects [% terms.bugs %] that are
marked as occurring on all platforms, i.e. are designated "All".
<h2><a name="op_sys">Operating System</a></h2>
This is the operating system against which the [% terms.bug %] was
reported. Legal operating systems include:
<ul>
<li>All (happens on all operating systems; cross-platform
[% terms.bug %])</li>
<li>Windows 95</li>
<li>Mac System 8.0</li>
<li>Linux</li>
</ul>
Sometimes the operating system implies the platform, but not
always. For example, Linux can run on PC and Macintosh and
others.
<h2><a name="assigned_to">Assigned To</a></h2>
<p>
This is the person in charge of resolving the [% terms.bug %]. Every time
this field changes, the status changes to <b>NEW</b> to make it
easy to see which new [% terms.bugs %] have appeared on a person's list.</p>
<p>
The default status for queries is set to NEW, ASSIGNED and
REOPENED. When searching for [% terms.bugs %] that have been resolved or
verified, remember to set the status field appropriately.
</p>
[% INCLUDE global/footer.html.tmpl %]

Просмотреть файл

@ -0,0 +1,65 @@
[%# 1.0@bugzilla.org %]
[%# The contents of this file are subject to the Mozilla Public
# License Version 1.1 (the "License"); you may not use this file
# except in compliance with the License. You may obtain a copy of
# the License at http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS
# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
# implied. See the License for the specific language governing
# rights and limitations under the License.
#
# The Original Code is the Bugzilla Bug Tracking System.
#
# The Initial Developer of the Original Code is Netscape Communications
# Corporation. Portions created by Netscape are
# Copyright (C) 1998 Netscape Communications Corporation. All
# Rights Reserved.
#
# Contributor(s): Terry Weissman <terry@mozilla.org>
# Gervase Markham <gerv@gerv.net>
#%]
[% PROCESS global/variables.none.tmpl %]
[% INCLUDE global/header.html.tmpl title = "Voting" %]
<p>[% terms.Bugzilla %] has a "voting" feature. Each product allows users to
have a certain number of votes. (Some products may not allow any, which means
you can't vote on things in that product at all.) With your vote, you indicate
which [% terms.bugs %] you think are the most important to be fixed.</p>
<p>Depending on how the administrator has configured the relevant product,
you may be able to vote for the same [% terms.bug %] more than one time. But
remember, you only have so many votes to use in total! So, you can either vote
a little for many [% terms.bugs %], or vote a lot for a few [% terms.bugs %].
</p>
<p>To look at votes:</p>
<ul>
<li>Go to the query page. Do a normal query, but enter 1 in the "At least
___ votes" field. This will show you items that match your query that
have at least one vote.</li>
</ul>
<p>To vote for a [% terms.bug %]:</p>
<ul>
<li>Bring up the [% terms.bug %] in question.</li>
<li>Click on the "Vote for this [% terms.bug %]" link that appears just
above the "Additional Comments" field. (If no such link appears, then voting
may not be allowed in this [% terms.bug %]'s product.)</li>
<li>Indicate how many votes you want to give this [% terms.bug %]. This page
also displays how many votes you've given to other [% terms.bugs %], so you
may rebalance your votes as necessary.</li>
</ul>
<p>You will automatically get email notifying you of any changes that occur
on [% terms.bugs %] you vote for.</p>
<p>You may review your votes at any time by clicking on the "<a href=
"votes.cgi?action=show_user">My Votes</a>" link in the page footer.</p>
[% INCLUDE global/footer.html.tmpl %]