On 2004-01-20 04:54, Clover wrote:

> x-post to qa.general and documentation
> post replies to documentation
> http://www.mozilla.org/quality/help/beginning-duplicate-finding.html
> 
> Just updated the how to find previous reported bugs page for the new 
> (actually, old) query layout: 
> http://www.mozilla.org/webtools/bonsai/cvsview2.cgi?diff_mode=context&whitespace_mode=show&file=beginning-duplicate-finding.html&branch=&root=/cvsroot&subdir=mozilla-org/html/quality/help&command=DIFF_FRAMESET&rev1=1.6&rev2=1.7
> 
> Other changes I want to do:
> 
>> The Mozilla developers want to hear about every specific and
>> reproducible bug that happens when you use Mozilla, but it does not
>> help to have the same bug reported many times. You can help to get
>> more bugs fixed faster by checking the Bugzilla database before
>> submitting your bug report, and not creating a duplicate report if
>> the bug you found has been reported already.
> 
> This page should also be targeted to new QAs who would like to improve 
> their bug query skills:
> 
> If you are:
> 
> *A bug reporter* : The Mozilla developers want to hear about every 
> specific, reproducible bug you find, but having the same bug reported 
> many times does not help. You can help to get bugs fixed faster by 
> checking the Bugzilla database before submitting your bug report, thus 
> avoiding duplicate reports. This article shows you know.
> 
> *A QA contributor* : Effective search skill can save valuable time 
> tracking down the bugs you would like to find. This article show you 
> tips to improve your bug search skills.

What about:
"This article provides you tips on how to improve your bug search skills."

> 
>> If you find that the problem you identified has already been
>> reported, do not report it again, but if you have something useful
>> to contribute, please do add a comment to the existing report.
> 
> If you find that the problem has already been reported, do not report it 
> again. However, if you have something useful to contribute, please do 
> add a comment to the existing report.
> 
> should there be <em> around "useful"?

No- this makes the document writers seem a little prejudiced towards
newbies. It's too negative.

>> Doing the Query
>> 
>> The Bugzilla Query Form looks dauntingly complex - it is complex and
>> powerful - ...
> 
> I would like to remove the left margin. I think <dd> is mis-used here.

Might be a good idea, because it gets even more confusing with the <ul>,
which moves some parts of the text even more to the right.

> 
>> But if you're using a milestone build,
> 
> This page should be targeted to new users who may not know terminologies 
> used in mozilla.org. We should use something other than "milestone", but 
> I can't think of an alternative now.

"a major release like %%MOZILLA-STABLE-VERSION%%".

> 
>> The Status field is set by default to find NEW, ASSIGNED, and REOPENED
>> bugs—the unfixed bugs. But if you're using a milestone build, you
>> should add RESOLVED and maybe VERIFIED (use Ctrl-click on MS-Windows,
>> Command-click on MacOS), especially if the milestone is a few weeks
>> old, since many bugs will have been fixed since your build was released.
> 
> In my experience, it is better to change Resolution field than Status 
> field. But for new users, Status might be easier.
> 
> We should expand this paragraph to:
> 
> *Status*
> 
> This field is set by default to find NEW, ASSIGNED, and REOPENED 
> bugs—the unfixed bugs. If you are using a non-development build, you 
> should add RESOLVED and VERIFIED, since many bugs will have been fixed 
> since your build was released (to select multiple items, use Ctrl-click 
> on Windows and Linux, and Command-click on Mac).
> 
> *Tip*: The *Resolution* field can sometimes be more helpful. For 
> example, if you want to search for both fixed and open bugs using the 
> status field, you practically need to check all status items, and the 
> results may include many irrelevent INVALID and WONTFIX bugs. You can do 
> this easily by matching for --- and FIXED resolution.
> 
> Note if Status and Resolution are both set, they may interfere with each 
> other. Normally it is safe to clear the Status field and set Resolution 
> only.

Maybe this should be emphazied in some way? I believe that this hint is
a very important one.

 To clear an item, press Shift and click the item.
> 
> Resolution Use
> 
> ---        Open bugs, including UNCONFIRMED, NEW, ASSIGNED, and REOPENED
> 
> DUPLICATE  Useful if cannot find the relevant open bug, but you
>             know/suspect that many users have experienced it and have
>             reported it many times.
> 
> WONTFIX    Useful if your bug is an enhancement and you want to find out
>             if it has already been decided not to be done.
> 
> INVALID
> WORKSFORME These are normally useful only for special cases.
> 
>> In the Product field, you should use:
> 
> This should be moved before Status because in the current layout it 
> appears before Status.

True.

> 
> We should add Tech Evangelism:
> 
> Tech Evangelism: If you are experiencing problem with a Web site, it may 
> be because the site uses proprietary technologies specific to certain 
> browsers, contains code error

"code errors"

, and un-intentionally blocks out new
> browsers released after the site goes online. The Tech Evangelism tracks 
> site issues that are not software problems.

"... that are not problems caused by mozilla.org software."
Just writing software errors doesn't make it clear enough that it's not
Mozilla's fault.

> Use the URL field in 
> combination with this product.
> 
>> Enter a word or short phrase that identifies the problem you saw as
>> uniquely as possible in the Summary field. Examples: view source,
>> auto proxy, drag drop, png image. If you enter more than one word and
>> they are not a phrase, change the type of matching for the Summary
>> field from contains the string  to contains all of the words/strings
>> or contains any of the words/strings, as appropriate (just to the left
>> of the text-entry field).
> 
> *Summary*
> Enter a word or short phrase that identifies the problem. The search 
> pattern should be as unique as possible. Examples:...
> 
>> Don't use the Keywords field without first clicking on the word
>> <a>Keywords</a>: you can't type just anything in there. If you try to use
>> this for keywords that are not on the list, it won't work, but some
>> of the defined keywords may be useful to narrow down your search.
> 
> *Keywords*
> Only certain terms are allowed in this field. You should check with 
> <a>keyword list</a> if you want to use it. Keywords can be helpful for 
> certain bugs:
> 
> crash - for software or system crash
> hang  - for problem where the software becomes unresponsive
>          temporarily or permenantly
> 4xp   - for features in Netscape 4.x but not in Mozilla 1.x
> intl  - for internationalization issues
> css1
> css2
> css3
> dom0
> dom1
> dom2 - for CSS and DOM problems
> regression
>      - for issues that do not occur in earilier builds/versions but
>        occur recently.

Is it really neccessary to list these keywords when there is a link to
the complete list directly above? Surely, these are the most important
ones, but still this list is a bit redundant.

> 
>> When you have done all that, click on the [Search] button. A new page
>> will load, and on it you should see a list of bugs that match your
>> query.
> 
> Wordy. remove the 2nd sentence


-- 
 Benedikt Kantus
 on a Thumperbunny nightly
_______________________________________________
mozilla-documentation mailing list
[EMAIL PROTECTED]
http://mail.mozilla.org/listinfo/mozilla-documentation

Reply via email to