Compare Revisions

Bug writing guidelines

Revision 12902:

Revision 12902 by Sir Sid on

Revision 12903:

Revision 12903 by Ferguz on

Title:
Bug writing guidelines
Bug writing guidelines
Slug:
Bug_writing_guidelines
Bug_writing_guidelines
Tags:
QA, Bugzilla
QA, Bugzilla
Content:

Revision 12902
Revision 12903
n46      If you have reproduced the bug in a recent build and no-onen46      I updated my Mozilla Firefox automatically yesterday to: Mo
> else appears to have reported it, then:>zilla/5.0 (Windows; U; Windows NT 5.1; es-ES; rv:1.8.1.4) Gecko/2
 >0070515 Firefox/2.0.0.4
47    </p>
48    <ol>
49      <li>Choose "<a class="external" href="https://bugzilla.mozi
>lla.org/enter_bug.cgi?format=guided">Enter a new bug</a>" (that f 
>orm incorporates parts of these guidelines) 
50      </li>
51      <li>Select the product in which you've found the bug
52      </li>
53      <li>Fill out the form. Here is some help understanding it:
54      </li>
55    </ol>
56    <p>
57      <b>Component:</b> In which sub-part of the software does it
> exist? 
n60      This field is required. Click the word "Component" to see an49      IT ERASED MY NESTCAPE ADDRESS BOOK FILE&nbsp;!!!!!!
> description of each component. If none seems appropriate, look f 
>or a "General" component. 
n63      <b>OS:</b> On which operating system (OS) did you find it? n52      ABOOK.MAB
>(e.g. Linux, Windows XP, Mac OS X.) 
n66      If you know the bug happens on more than one type of operatn55      Thank you guysa
>ing system, choose "All". If your OS isn't listed, choose Other. 
n69      <b>Summary:</b> How would you describe the bug, in approximn58      Fernando Guzman ferguz
>ately 60 or fewer characters? 
n71    <p>n60    <h2 name="Original_document_information">
72      A good summary should quickly and uniquely identify a bug r61      Original document information
>eport. It should explain the problem, not your suggested solution 
>. 
73    </p>62    </h2>
n75      <li>Good: "Cancelling a File Copy dialog crashes File Managn64      <li>Author(s): Gervase Markham, based on an original by Eli
>er"> Goldberg
n77      <li>Bad: "Software crashes"n66      <li>Other Contributors: Claudius Gayle, Jan Leger, Felix Mi
 >ata, Peter Mock, Chris Pratt, Chris Yeh, and others.
78      </li>
79      <li>Bad: "Browser should work with my web site"
t83      <b>Description:</b> The details of your problem report, inct70      &lt;/div&gt;
>luding: 
84    </p>
85    <div class="highlight">
86      <p>
87        <b>Overview:</b> More detailed restatement of summary.
88      </p>
89      <pre class="eval">
90Drag-selecting any page crashes Mac builds in the NSGetFactory fu
>nction. 
91</pre>
92      <p>
93        <b>Steps to Reproduce:</b> Minimized, easy-to-follow step
>s that will trigger the bug. Include any special setup steps. 
94      </p>
95      <pre class="eval">
961) View any web page. (I used the default sample page, 
97resource:/res/samples/test0.html)
98 
992) Drag-select the page. (Specifically, while holding down 
100the mouse button, drag the mouse pointer downwards from any 
101point in the browser's content region to the bottom of the 
102browser's content region.)
103</pre>
104      <p>
105        <b>Actual Results:</b> What the application did after per
>forming the above steps. 
106      </p>
107      <pre class="eval">
108The application crashed.
109</pre>
110      <p>
111        <b>Expected Results:</b> What the application should have
> done, were the bug not present. 
112      </p>
113      <pre class="eval">
114The window should scroll downwards. Scrolled content should be se
>lected.  
115(Or, at least, the application should not crash.)
116</pre>
117      <p>
118        <b>Build Date &amp; Platform:</b> Date and platform of th
>e build in which you first encountered the bug. 
119      </p>
120      <pre class="eval">
121Build 2006-08-10 on Mac OS 10.4.3
122</pre>
123      <p>
124        <b>Additional Builds and Platforms:</b> Whether or not th
>e bug takes place on other platforms (or browsers, if applicable) 
>. 
125      </p>
126      <pre class="eval">
127Doesn't Occur On Build 2006-08-10 on Windows XP Home (Service Pac
>k 2) 
128</pre>
129      <p>
130        <b>Additional Information:</b> Any other useful informati
>on. 
131      </p>
132      <p>
133        For crashing bugs:
134      </p>
135      <ul>
136        <li>Win32: If you receive a Dr. Watson error, please note
> the type of the crash, and the module that the application crash 
>ed in. (e.g. access violation in mozilla.exe) 
137        </li>
138        <li>Mac OS X: When the application crashes, click the "Re
>port" button in the notification window that appears, then copy a 
>ll the text from the text box under the message "Problem and syst 
>em information" and include it with your bug report. There's no n 
>eed to send the bug to Apple, so just click the red close box at  
>the top of the window. 
139        </li>
140        <li>Unix: Please provide a minimized stack trace, which c
>an be generated by typing <tt>gdb mozilla core</tt> into a shell  
>prompt. 
141        </li>
142      </ul>
143      <pre>
144Date/Time:      2006-12-26 12:15:20.089 -0500
145OS Version:     10.4.8 (Build 8L2127)
146Report Version: 4
147 
148Command: firefox-bin
149Path:    /Applications/Firefox.app/Contents/MacOS/firefox-bin
150Parent:  WindowServer [71]
151 
152Version: 2.0.0.1 (2.0.0.1)
153 
154PID:    114
155Thread: 0
156 
157Exception:  EXC_BAD_ACCESS (0x0001)
158Codes:      KERN_PROTECTION_FAILURE (0x0002) at 0x000000ca
159 
160Thread 0 Crashed:
1610   libxpcom_core.dylib         0x0186329b AppendUTF8toUTF16(char
> const*, nsAString_internal&amp;) + 31 
1621   libxpcom_core.dylib         0x01822916 nsTextFormatter::smpri
>ntf_free(unsigned short*) + 3248 
163... (many many more lines like this) ...
164</pre>
165    </div>
166    <p>
167      <b>Add an attachment:</b> You can attach relevant files to 
>a bug report. Debugging information more than 20 lines long shoul 
>d be supplied this way. Also, if you have an HTML file that demon 
>strates the bug, you should attach that. You can only attach one  
>file during initial submission so if your demonstration needs mor 
>e, revisit the newly filed bug to do this part. Attach any subsid 
>iary files (such as images) first and then edit the HTML file to  
>point to the new URLs of the attached files before uploading, so  
>the demo is self-contained. Ask before attaching more than five f 
>iles. 
168    </p>
169    <p>
170      Double-check your report for errors and omissions, then pre
>ss "Commit". Your bug report will now be in the Bugzilla database 
>. 
171    </p>
172    <div class="originaldocinfo">
173      <h2 name="Original_document_information">
174        Original document information
175      </h2>
176      <ul>
177        <li>Author(s): Gervase Markham, based on an original by E
>li Goldberg 
178        </li>
179        <li>Other Contributors: Claudius Gayle, Jan Leger, Felix 
>Miata, Peter Mock, Chris Pratt, Chris Yeh, and others. 
180        </li>
181      </ul>
182    </div>{{ wiki.languages( { "ja": "ja/Bug_writing_guidelines" 71    </p>{{ wiki.languages( { "ja": "ja/Bug_writing_guidelines" } 
>} ) }}>) }}

Back to History