summaryrefslogtreecommitdiffstats
path: root/template/en/default/bug/create
diff options
context:
space:
mode:
authorgerv%gerv.net <>2005-01-01 21:50:46 +0100
committergerv%gerv.net <>2005-01-01 21:50:46 +0100
commit8cf3b0b2556edb2b7e7c77d65c681be3fbede7d9 (patch)
tree7b81422ea37af346607a872bbb8ddcf169d6ae24 /template/en/default/bug/create
parent1e622db02806e0ba14e8ee86ca59091d05a8f349 (diff)
downloadbugzilla-8cf3b0b2556edb2b7e7c77d65c681be3fbede7d9.tar.gz
bugzilla-8cf3b0b2556edb2b7e7c77d65c681be3fbede7d9.tar.xz
Bug 267671 - updates to the Bugzilla Helper to make it clearer and easier to use, and to set expectations appropriately. Patch by gerv; r=myk, a=justdave.
Diffstat (limited to 'template/en/default/bug/create')
-rw-r--r--template/en/default/bug/create/create-guided.html.tmpl281
1 files changed, 123 insertions, 158 deletions
diff --git a/template/en/default/bug/create/create-guided.html.tmpl b/template/en/default/bug/create/create-guided.html.tmpl
index f7affee10..87f7a668f 100644
--- a/template/en/default/bug/create/create-guided.html.tmpl
+++ b/template/en/default/bug/create/create-guided.html.tmpl
@@ -36,11 +36,13 @@
<p>
<font color="red">
- This is a template used on mozilla.org - it, along with the
- comment-guided.txt.tmpl template, are included as a demo of what it's
+ This is a template used on mozilla.org. This template, and the
+ comment-guided.txt.tmpl template that formats the data submitted via
+ the form in this template, are included as a demo of what it's
possible to do with custom templates in general, and custom [% terms.bug %]
- entry templates in particular. You will need to alter the text of this
- template if you want to use it on your [% terms.Bugzilla %] installation.
+ entry templates in particular. As much of the text will not apply,
+ you should alter it
+ if you want to use this form on your [% terms.Bugzilla %] installation.
</font>
</p>
@@ -65,24 +67,7 @@ function PutDescription() {
}
</script>
-[%# Browser sniff to try and reduce the incidence of 4.x and NS 6/7 bugs %]
-
-[% IF cgi.user_agent("Mozilla/4") AND NOT cgi.user_agent("compatible") %]
- <div style="background-color: lightgrey;
- border: 1px solid black;
- padding: 2px">
- <font color="#990000">
- <b>
- Note: This is a tool for reporting [% terms.bugs %] in software from
- mozilla.org. Use Netscape's
- <a href="http://help.netscape.com/forms/bug-client.html">[% terms.bug %]
- reporting form</a> to report [% terms.bugs %] with Netscape products
- like Navigator 4.x. Netscape products have a blue and black N in the
- top right hand corner.
- </b>
- </font>
- </div>
-[% END %]
+[%# Browser sniff to try and reduce the incidence of Netscape 6/7 bugs %]
[% IF cgi.user_agent('Netscape(\d)') %]
[% matches = cgi.user_agent().match('Netscape(\d)') %]
@@ -102,103 +87,84 @@ function PutDescription() {
in Netscape [% matches.0 %] with this form, you must reproduce it first in
a recent build of
<a href="http://ftp.mozilla.org/pub/mozilla.org/mozilla/nightly/latest/">Mozilla</a>,
- <a href="http://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-trunk/">Firefox</a> or
+ <a href="http://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-trunk/">Firefox</a>,
+<a href="http://ftp.mozilla.org/pub/mozilla.org/thunderbird/nightly/latest-trunk/">Thunderbird</a> or
<a href="http://ftp.mozilla.org/pub/mozilla.org/camino/nightly/latest/">Camino</a>
to make sure the problem hasn't been fixed already.
</div>
[% END %]
-<p>
- This form prompts you for the information required to
- file a good [% terms.bug %] report (or enhancement request.)
- It may seem lengthy, but developers need all this information
- to understand and reproduce the [% terms.bug %], which is the first step towards
- fixing it. Please note that <strong>we do not accept [% terms.bug %] reports by
- email</strong> - please do not email developers or mozilla.org staff
- with [% terms.bug %] reports. <font color="red">Also, please do not
- file [% terms.bugs %] on browser/email software older than two weeks - first,
- download a newer build of
- <a href="http://ftp.mozilla.org/pub/mozilla.org/mozilla/nightly/latest/">Mozilla</a>,
- <a href="http://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-trunk/">Firefox</a>,
- <a href="http://ftp.mozilla.org/pub/mozilla.org/camino/nightly/latest/">Camino</a>
- or
- <a href="http://ftp.mozilla.org/pub/mozilla.org/thunderbird/nightly/">Thunderbird</a>
- and check that the problem is still present.
- </font>
-</p>
+[% IF cgi.user_agent('Gecko/') %]
+ [% matches = cgi.user_agent().match('Gecko/(\d+)') %]
+
+[% END %]
+
+<!-- @@@ Need UA checking here -->
<a name="step1"></a>
-<h3>Step 1 - search for your [% terms.bug %]</h3>
+<h3>Step 1 of 3 - has your [% terms.bug %] already been reported?</h3>
<p>
- Please see if your [% terms.bug %] has already been reported.
- <font color="red">Please don't skip this step.</font>
- 50% of the [% terms.bugs %] filed in
- [%+ terms.Bugzilla %] are duplicates, and this wastes a lot of our QA engineers' time.
+ <font color="red">Please don't skip this step - half of all bugs filed are
+ reported already.</font>
+ Check the two lists of frequently-reported [% terms.bugs %]:
</p>
-[%# Stop NS 4.x and all v.3 browsers from getting <iframe> code %]
-[% IF (cgi.user_agent("Mozilla/4")
- AND NOT cgi.user_agent("compatible"))
- OR (cgi.user_agent("Mozilla/[123]")) %]
- <p>
- Visit the <a href="duplicates.cgi">most-frequently-reported [% terms.bugs %] page</a>
- and see if your [% terms.bug %] is there. If not, go to the
- <a href="query.cgi?format=modern">search page</a>
- and search [% terms.Bugzilla %] by entering two or
- three of the main words having to do with your [% terms.bug %] in the top box.
- For example: <tt><b>pop3 mail</b></tt> or <tt><b>copy paste</b></tt>.
- </p>
+[%# Include other products if sensible %]
+[% IF product == "Firefox" %]
+ [% productstring = "product=Mozilla%20Application%20Suite&amp;product=Firefox" %]
+[% ELSIF product == "Thunderbird" %]
+ [% productstring = "product=Mozilla%20Application%20Suite&amp;product=Thunderbird" %]
[% ELSE %]
- <p>
- Check the list of most-frequently-reported [% terms.bugs %] below.
- If your [% terms.bug %] isn't there, search [% terms.Bugzilla %] by entering two or
- three of the main words having to do with your [% terms.bug %] in this box.
+ [% productstring = "product=" _ product FILTER uri %]
+[% END %]
+
+<p>
+ <a href="duplicates.cgi?[% productstring %]&format=simple" target="somebugs">All-time Top 100</a> (loaded initially) |
+ <a href="duplicates.cgi?[% productstring %]&format=simple&sortby=delta&reverse=1&maxrows=100&changedsince=14" target="somebugs">Hot in the last two weeks</a>
+</p>
+
+<iframe name="somebugs" width="100%" height="80%"
+ style="border: 2px black solid"
+ src="duplicates.cgi?[% productstring %]&format=simple">
+</iframe>
+
+<p>
+ If your [% terms.bug %] isn't there, search [% terms.Bugzilla %] by entering
+ a few key words having to do with your [% terms.bug %] in this box.
For example: <tt><b>pop3 mail</b></tt> or <tt><b>copy paste</b></tt>.
+ The results will appear above.
</p>
+[%# All bugs opened inside the past six months %]
<form action="buglist.cgi" method="get" target="somebugs">
<input type="hidden" name="format" value="simple">
<input type="hidden" name="order" value="relevance desc">
- <input type="hidden" name="bug_status" value="__open__">
+ <input type="hidden" name="bug_status" value="__all__">
<input type="hidden" name="product" value="[% product FILTER html %]">
+ <input type="hidden" name="chfieldfrom" value="-6m">
+ <input type="hidden" name="chfieldto" value="Now">
+ <input type="hidden" name="chfield" value="[Bug creation]">
<input type="text" name="content" size="40">
<input type="submit" value="Search">
</form>
- <iframe name="somebugs" width="100%" height="80%"
- style="border: 2px black solid"
- src="duplicates.cgi?product=[% product FILTER uri %]&format=simple">
- </iframe>
-[% END %]
-
<p>
Look through the search results. If you get the
- <tt><b>Zarro Boogs</b></tt> message, [% terms.Bugzilla %] found no [% terms.bugs %] that
- match. Check for typos, or add fewer or different keywords.
-</p>
-
-<p>
- If you find [% terms.abug %] that looks the same as yours, you can add
- useful comments to that [% terms.bug %], but please don't open a new one.
- Please don't add comments like "please fix this [% terms.bug %]" - this
- tends to annoy engineers and slow, rather than speed, the fixing of it.
-</p>
-
-<p>
- If you find [% terms.bugs %] similar to yours, read them and note which component
- they are in. You should file your [% terms.bug %] in that same component.
+ <tt><b>Zarro Boogs</b></tt> message, [% terms.Bugzilla %] found no
+ [% terms.bugs %] that
+ match. Check for typing mistakes, or try fewer or different keywords.
+ If you find [% terms.abug %] that looks the same as yours, please add
+ any useful extra information you have to it, rather than opening a new one.
</p>
<a name="step2"></a>
-<h3>Step 2 - give information</h3>
+<h3>Step 2 of 3 - give information</h3>
<p>
- If you're pretty certain that your [% terms.bug %] isn't in there already, then
- please try to complete this form as accurately as you
- can. The more you can tell us, the better our chance of being able
- to understand and reproduce your [% terms.bug %].
+ If you've tried a few searches and your [% terms.bug %] really isn't in
+ there, tell us all about it.
</p>
<form method="post" action="post_bug.cgi">
@@ -212,7 +178,7 @@ function PutDescription() {
<table valign="top" cellpadding="5" cellspacing="5" border="0">
<tr bgcolor="[% tablecolour %]">
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Product</b>
</td>
<td valign="top">
@@ -222,19 +188,10 @@ function PutDescription() {
</tr>
<tr>
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Component</b>
</td>
<td valign="top">
- <p>
- The area where the problem occurs.
- To pick the right component, you could use the same one as
- similar [% terms.bugs %] you found in your search, or read the full list of
- <a href="describecomponents.cgi?product=
- [% product FILTER url_quote %]">component
- descriptions</a> if you need more help.
- </p>
-
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
@@ -261,6 +218,15 @@ function PutDescription() {
</td>
</tr>
</table>
+
+ <p>
+ The area where the problem occurs.
+ To pick the right component, you could use the same one as
+ similar [% terms.bugs %] you found in your search, or read the full list of
+ <a target="_blank" href="describecomponents.cgi?product=
+ [% product FILTER url_quote %]">component
+ descriptions</a> (opens in new window) if you need more help.
+ </p>
</td>
</tr>
@@ -269,7 +235,7 @@ function PutDescription() {
[% rep_platform = [ "PC", "Macintosh", "All", "Other" ] %]
<tr bgcolor="[% tablecolour %]">
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Hardware Platform</b>
</td>
<td valign="top">
@@ -282,7 +248,7 @@ function PutDescription() {
"Linux", "All", "other" ] %]
<tr>
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Operating System</b>
</td>
<td valign="top">
@@ -294,46 +260,46 @@ function PutDescription() {
[% buildid = cgi.user_agent() IF matches %]
<tr bgcolor="[% tablecolour %]">
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Build Identifier<br>(User Agent)</b>
</td>
<td valign="top">
+ <input type="text" size="80" name="buildid" value="[% buildid %]">
<p>
- If reporting [% terms.abug %] in Mozilla,
+ This identifies exactly the version of the product you were using.
+ If reporting [% terms.abug %] in Mozilla or Firefox,
this is the line beginning <tt>"Mozilla/5.0"</tt> in
- <tt>Help | About Mozilla</tt>.
- It identifies exactly the version of Mozilla you were using.
- If you are using the problem copy of Mozilla, this will be
- filled in correctly for you already.
- If Mozilla won't start, just enter the URL of the directory you
+ <tt>Help | About</tt>.
+ If you are using the problematic software to file the bug, this
+ field will already be filled in correctly.
+ If the product won't start, just enter the complete URL you
downloaded it from.
</p>
- <input type="text" size="80" name="buildid" value="[% buildid %]">
</td>
</tr>
<tr>
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>URL</b>
</td>
<td valign="top">
+ <input type="text" size="80" name="bug_file_loc" value="http://">
<p>
URL that demonstrates the problem you are seeing (optional.)
- <b>IMPORTANT</b>: If you are filing [% terms.abug %] about a broken web page,
- please read the
- <a href="http://www.mozilla.org/docs/web-developer/faq.html">Mozilla
- Web Developer FAQ</a>, which explains how we handle old or
- badly-coded web pages.
+ <!--
+ <b>IMPORTANT</b>: problems with broken web pages go
+ <a href="http://write-this-webtool/">in this form instead</a>.
+ -->
</p>
- <input type="text" size="80" name="bug_file_loc" value="http://">
</td>
</tr>
<tr bgcolor="[% tablecolour %]">
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Summary</b>
</td>
<td valign="top">
+ <input type="text" size="80" name="short_desc" id="short_desc">
<p>
A sentence which summarises the problem.
Please be descriptive and use lots of keywords.
@@ -348,51 +314,47 @@ function PutDescription() {
crash if I close the mail window while checking for new POP mail
</tt>
</p>
- <input type="text" size="80" name="short_desc" id="short_desc">
</td>
</tr>
<tr>
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Details</b>
</td>
<td valign="top">
+ <textarea rows="6" cols="80" name="comment"
+ wrap="hard"></textarea>
<p>
Expand on the Summary. Please be
as specific as possible about what is wrong.
</p>
<p>
<tt>
- <font color="#990000">Bad example</font>: This page looks wrong in
- Mozilla. Other browsers display it correctly. You suck!
+ <font color="#990000">Bad example</font>: Mozilla crashed.
+ You suck!
</tt>
<br>
<tt>
- <font color="#009900">Good example</font>: In the
- page at http://www.foo.com/, text in the first column should be
- fully justified -- text should be aligned with both the left and
- right margins. In Mozilla, the text is only left-justified.
+ <font color="#009900">Good example</font>: After a crash which
+ happened when I was sorting in the Bookmark Manager,<br> all of my
+ top-level bookmark folders beginning with the letters Q to Z are
+ no longer present.
</tt>
</p>
- <textarea rows="6" cols="80" name="comment"
- wrap="hard"></textarea>
</td>
</tr>
<tr bgcolor="[% tablecolour %]">
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Reproducibility</b>
</td>
<td valign="top">
- <p>
- How often can you reproduce the problem?
- </p>
<select name="reproducible">
<option name="AlwaysReproducible" value="Always">
- Every time.
+ Happens every time.
</option>
<option name="Sometimes" value="Sometimes">
- Sometimes, but not always.
+ Happens sometimes, but not always.
</option>
<option name="DidntTry" value="Didn't try">
Haven't tried to reproduce it.
@@ -405,53 +367,55 @@ function PutDescription() {
</tr>
<tr>
- <td align="right" valign="middle">
+ <td align="right" valign="top">
<b>Steps to Reproduce</b>
</td>
<td valign="top">
- <p>
- Describe how to reproduce the problem, step by
- step. Include any special setup steps.
- </p>
<textarea rows="4" cols="80" name="reproduce_steps" wrap="hard">
1.
2.
3.
</textarea>
+ <p>
+ Describe how to reproduce the problem, step by
+ step. Include any special setup steps.
+ </p>
</td>
</tr>
<tr bgcolor="[% tablecolour %]">
- <td valign="middle" align="right">
+ <td valign="top" align="right">
<b>Actual Results</b>
</td>
<td valign="top">
+ <textarea rows="4" cols="80" name="actual_results"
+ wrap="hard"></textarea>
<p>
What happened after you performed the steps above?
</p>
- <textarea rows="4" cols="80" name="actual_results"
- wrap="hard"></textarea>
</td>
</tr>
<tr>
- <td valign="middle" align="right">
+ <td valign="top" align="right">
<b>Expected Results</b>
</td>
<td valign="top">
+ <textarea rows="4" cols="80" name="expected_results"
+ wrap="hard"></textarea>
<p>
What should the software have done instead?
</p>
- <textarea rows="4" cols="80" name="expected_results"
- wrap="hard"></textarea>
</td>
</tr>
<tr bgcolor="[% tablecolour %]">
- <td valign="middle" align="right">
+ <td valign="top" align="right">
<b>Additional Information</b>
</td>
<td valign="top">
+ <textarea rows="8" cols="80" name="additional_info"
+ wrap="hard"></textarea>
<p>
Add any additional information you feel may be
relevant to this [% terms.bug %], such as the <b>theme</b> you were
@@ -470,25 +434,15 @@ function PutDescription() {
which the software crashed (e.g., <tt>Application Violation in
gkhtml.dll</tt>).
</p>
- <textarea rows="8" cols="80" name="additional_info"
- wrap="hard"></textarea>
</td>
</tr>
<tr>
- <td valign="middle" align="right">
+ <td valign="top" align="right">
<b>Severity</b>
</td>
<td valign="top">
- <p>
- How serious the problem is. Also, if your [% terms.bug %] is a request for a new
- feature or enhancement, say so here.
- </p>
<select name="bug_severity">
- <option name="blocker" value="blocker">
- Blocker: This [% terms.bug %] prevents Mozilla developers from
- testing or developing the software.
- </option>
<option name="critical" value="critical">
Critical: The software crashes, hangs, or causes you to
lose data.
@@ -510,13 +464,17 @@ function PutDescription() {
Enhancement: Request for new feature or enhancement.
</option>
</select>
+ <p>
+ Say how serious the problem is, or if your [% terms.bug %] is a
+ request for a new feature.
+ </p>
</td>
</tr>
</table>
<a name="step3"></a>
-<h3>Step 3 - submit the [% terms.bug %]</h3>
+<h3>Step 3 of 3 - submit the [% terms.bug %] report</h3>
<p>
<input type="submit" value=" Submit [% terms.Bug %] Report "
@@ -528,7 +486,14 @@ function PutDescription() {
<p>
That's it! Thanks very much. You'll be notified by email about any
- progress that is made on fixing your [% terms.bug %].
+ progress that is made on fixing your [% terms.bug %].
+
+<p>
+ Please be warned
+ that we get a lot of bug reports filed - it may take quite a while to
+ get around to yours. You can help the process by making sure your bug is
+ complete and easy to understand, and by quickly replying to any questions
+ which may arrive by email.
</p>
</form>