View source for Using ROSA Bugzilla

ROSA Bugzilla is located at http://bugs.rosalinux.ru/.  The main purpose of this site is to serve as a central point of contact with distribution maintainers and developers about the problems in the ROSA Desktop distributions.

To file bugs there, you should "register" at Bugzilla itself, ABF credentials won't work.

=== What issues are tracked in ROSA Bugzilla? ===

[http://bugs.rosalinux.ru/ ROSA Bugzilla] is used to track all "downstream" issues with ROSA Desktop, and some problems with ROSA Bugzilla infrastructure.  Here's the list of issues you should file to the Bugzilla:

# Bugs in already released ROSA Desktop distributions;
# Bugs in packages and distributions that have not yet been released.
# Issues with ROSA collaboration infrastructure, such as forums, wiki and ROSA Bugzilla itself.

=== How to report a bug ===

The ROSA Bugzilla, though it has some specific tweaks, is just a usual bugzilla.  The interface is most likely familliar to you: if you saw one issue tracker then you've seen them all.

To report a new bug, or to comment on an existing one, you should obtain an account first by registering at the bugzilla itself.  ABF credentials do not work.  ROSA corporate mail credentials do not work.  Your can't register via your Facebook or Twitter account either.  We tried to keep it simple.

After that, just click "New", select a product you wish to report bug (most likely, it will be "ROSA Linux")<ref>The hints and design of the "New bug" page was inspired by [http://qa.mandriva.com/ Mandriva Bugzilla], and some texts were borrowed from there.</ref>.  Specify the category you want to report the bug against; if unsure, select "Main Packages".  When you report a bug, you should specify a package you have problems with; the bug filing form contains instructions on how to obtain this information.  This information is used to determine the person responsible for fixing the bug<ref>This is not yet implemented, but is coming very soon, by the end of May 2012.</ref>.  Fill all the fields in the form, following the instructions listed nearby.

If you think your bug is sensitive, read [[#Security and business-sensitive issues|this section]].

=== Accompanying mailing lists ===

There are two mailing list useful to make the interaction with the bug tracker easier

* bugs@lists.rosalab.ru — notifications about all new bugs that aren't marked as "sensitive" (see [[#Security and business-sensitive issues|here]]) and about changes made to them are sent to this list.  You may subscribe at your own automatically [http://lists.rosalab.ru/mailman/listinfo/bugs here];
* private-bugs@lists.rosalab.ru — notifications about [[#Security and business-sensitive issues|sensitive bugs]] are sent here.  Only a ROSA employee may subscribe, via [http://lists.rosalab.ru/mailman/listinfo/private-bugs this form].

=== How to propose a feature ===

To propose a feature, [http://bugs.rosalinux.ru/enter_bug.cgi?product=Features open a new Bugzilla ticket in "Features" product].  The feature will be reviewed by developers as soon as possible, and it will be decided if it's worth allocating resources at, or if the feature fits the overall concept of ROSA Desktop.  Make sure you have [http://bugs.rosalinux.ru/query.cgi?format=specific&product=Features  searched for similar features] (or reviewed the [http://bugs.rosalinux.ru/buglist.cgi?list_id=2646&query_format=advanced&product=Features list of all features]) because your proposal might have already been reviewed.

If the feature is so sensitive to ROSA business that it should be kept secret from the broad audience, select "ROSA employees" group restriction at the bottom of the bug.

See [[#Useful links]] for the list of feature-related queries.

=== Useful links ===

Bugzilla has an advanced bug search and filter mechanism, though it's not easy to use.  I gathered some useful search queries here:

==== Update request tracking ====

* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=flagtypes.name&list_id=4190&v1=qa_verified%3F&o1=substring&product=Desktop%20Bugs requests pending QA approval]
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=flagtypes.name&v1=secteam_verified%3F&o1=substring&product=Desktop%20Bugs&list_id=4192 Update requests pending secteam approval]
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=flagtypes.name&v1=published%3F&o1=substring&product=Desktop%20Bugs&list_id=4217 Update requests pending Repo-man approval]
* [http://bugs.rosalinux.ru/buglist.cgi?n2=1&f1=flagtypes.name&o1=substring&query_based_on=qa_pending_week&o2=changedafter&query_format=advanced&f2=flagtypes.name&v1=qa_verified%3F&component=Localization&component=Main%20Packages&v2=7d&product=Desktop%20Bugs&known_name=qa_pending_week&list_id=4194 Update requests that have been pending QA approval for more than a week]

==== Feature and task tracking ====

* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&bug_status=UNCONFIRMED&columnlist=short_desc%2Cpriority%2Cassigned_to%2Cbug_status%2Cresolution%2Cchangeddate&product=Desktop%20Features&list_id=4196 All unconfirmed features]
* [http://bugs.rosalinux.ru/buglist.cgi?list_id=4202&columnlist=short_desc%2Cpriority%2Cassigned_to%2Cbug_status%2Cresolution%2Cchangeddate&query_based_on=recent_features&chfieldto=Now&chfield=%5bBug%20creation%5d&query_format=advanced&chfieldfrom=15d&bug_status=UNCONFIRMED&product=Desktop%20Features&known_name=recent_features all ''recently'' proposed features];
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=target_milestone&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=short_desc%2Cpriority%2Cassigned_to%2Cbug_status%2Cresolution%2Cchangeddate&v1=2012%20Desktop&o1=substring&product=Desktop%20Features&list_id=4204 all accepted features for ''2012 Desktop'' release];
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=target_milestone&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=short_desc%2Cpriority%2Cassigned_to%2Cbug_status%2Cresolution%2Cchangeddate&v1=2012%20Desktop&o1=substring&product=Desktop%20Bugs&product=Desktop%20Features&list_id=4205 all accepted features ''and'' important bugfixes for ''2012 Desktop'' release];
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&product=Desktop%20Features&list_id=4206 all features (regardless of their status];

==== Triaging ====

* [http://bugs.rosalinux.ru/buglist.cgi?f1=flagtypes.name&list_id=4298&o1=notsubstring&resolution=---&query_format=advanced&v1=need_info&component=-Enter%20Bugs%20Here-&product=Desktop%20Bugs bugs awaiting triage];
* [http://bugs.rosalinux.ru/buglist.cgi?n2=1&f1=flagtypes.name&o3=changedbefore&list_id=4300&v3=5d&o1=notsubstring&resolution=---&o2=changedafter&query_format=advanced&f3=creation_ts&f2=flagtypes.name&v1=need_info%3F&component=-Enter%20Bugs%20Here-&v2=5d&product=Desktop%20Bugs bugs that have been awaiting triage for more than 5 days]  (triagers are to clear this list, see [[Bugs/Workflow]]);
* [http://bugs.rosalinux.ru/buglist.cgi?n2=1&f1=flagtypes.name&list_id=4306&o1=substring&resolution=---&query_based_on=should_be_closed_as_old&o2=changedafter&query_format=advanced&f2=flagtypes.name&v1=need_info%3F&component=-Enter%20Bugs%20Here-&v2=90d&known_name=should_be_closed_as_old old bugs that have been waiting for user's response for 90 days] (should be closed; see [[Bugs/Workflow]])

==== Developers ====

* '''[http://bugs.rosalinux.ru/buglist.cgi?f1=cf_upstream&list_id=4277&o1=nowordssubstr&resolution=---&o2=greaterthaneq&query_format=advanced&f2=bug_severity&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&v1=wontfix%20known%20unknown&component=Main%20Packages&v2=normal&product=Desktop%20Bugs Only Severe, Non-Upstream, Triaged bugs in Main repo]'''.  See [[Bugs/Severity]].
* [http://bugs.rosalinux.ru/buglist.cgi?f1=cf_upstream&list_id=4275&o1=nowordssubstr&resolution=---&query_format=advanced&v1=wontfix%20known%20unknown&product=Desktop%20Bugs only non-upstream bugs in ROSA Desktop]
* [http://bugs.rosalinux.ru/buglist.cgi?f1=cf_upstream&list_id=4273&o1=anywordssubstr&resolution=---&query_format=advanced&v1=wontfix%20known%20unknown&product=Desktop%20Bugs upstream bugs in ROSA Desktop]

==== Misc ====

* [http://bugs.rosalinux.ru/buglist.cgi?resolution=---&query_format=advanced&component=Package%20Requests&list_id=4207 requests for new packages]
* [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=cf_iso&v1=yes&o1=equals&product=Desktop%20Bugs&list_id=4208 list all ISO-related bugs]

=== Security and business-sensitive issues ===

If your issue is sensitive because

# you are reporting a security bug;
# you are a ROSA employee, contractor, or customer, and want to raise a business-sensitive issue;

you should click '''"ROSA Employees" checkbox''' at the bottom of the bug file form.  This will make the bug visible to you and ROSA employees only.<ref>In case you're worried about this, "QA contact" field will automatically be reset to a private mailing list in this case".</ref>

Warning!  '''If you forget to set this checkbox, the bug comment will automatically be disseminated through a public mailing list, and you can't cancel it later'''.  Please, be careful with this.

If you need greater security, contact admins; see [[#What to do if there's a problem with the Bugzilla]].

=== How to edit a comment ===

There is no way to edit a comment in Bugzilla once it has been published.   Post a new one instead.

Bugzilla comments are used to track the whole history of the work made on a bug.  Editing a comment might also affect the responses to it, and whether [[Requesting an Update|an update]] was approved/rejected.  That's why we would turn off the ability to edit comments even if it was present in the stock Bugzilla.

=== ROSA-sepcific features ===

[[File:rosa-bz-features-urc.png|thumb|"Request for Update" checkbox]][http://bugs.rosalinux.ru/ ROSA Bugzilla] has a number of tweaks that aid us in the development process of ROSA linux distribution.  Here's a list of them.

==== Update Request checkbox ====

[[File:rosa-bz-features-furrc.png|thumb|Filtered comment stream]]The process of updating a released ROSA Linux distribution is built on top of Bugzilla.  You can read more in [[Requesting an Update]] policy.  An interface of bugzilla was extended with a "Request for Update" checkbox.  The value of this checkbox denotes whether this bug is also an update request.  The checkbox also helps you to fulfill the requirements of the [[Requesting an Update]] policy by disabling itself if your comment doesn't have enough information.

When you set this checkbox, the QA (or some other party your update had issues with, Security team, for instance) is notified about the change, and will process your update in a timely manner.  By changing the checkbox state ''and'' committing your change you may notify QA if the package is ready (if you set the checkbox), or cancel the request (if you unset the checkbox).

==== Filtering Update Request-related comments ====

To aid QA teams in reading the bug comments efficiently, we added a filter that expands only update-related comments.  These are comments that contain the keyword "advisory" '''or''' a link to ABF build list.  To use the filter, you must have Javascript enabled in your browser.

[[File:Rosa-bz-features-hlur.png|thumb|Highlighted update request comments]]
==== Highlighting Update Request comments ====

Comments that may be related to update requests are highlighted with a greener color, so they can be identified easier in a (possibly) long comment stream.  See the screenshot for an example.

Please, note that '''this only works with the default "Dusk" theme'''!

==== Common transitions for ROSA teams ====

Some transitions in the process of [[Requesting an Update|update verification]] are too common to make the team members make many clicks during common operations.  Some buttons were added that use Javascript to switch flags and statuses after a QA, secteam or repo-man have worked on the package.

Note that '''these buttons do not save changes, they just switch the status.  To save the changes you should click "Save Changes" and write a comment!'''

Only buttons relevant to a specific team are displayed.  The screenshot to the right is just an illustration that gathers them all in a single screen.

[[File:Rosa-bz-features-commonclicks.png|thumb|Some of these buttons are shown to the teams to aid them in the update process]]

==== "ISO-related" checkbox ====

ROSA Desktop products have "ISO-related" checkbox.  The flag should be used by release-managers to mark bugs they will look through when assembling an ISO.  As soon as the bug is fixed in ISO, this flag may be removed.

Here is a [http://bugs.rosalinux.ru/buglist.cgi?query_format=advanced&f1=cf_iso&list_id=3322&v1=yes&o1=equals&product=Features&product=ROSA%20Linux query to list all bugs with this checkbox set].

=== What to do if there's a problem with the Bugzilla ===

If you have successfully obtained an account, and want to report a broken link, or a problem with Bugzilla functionality, or want to ask for specific permissions, please, [http://bugs.rosalinux.ru/enter_bug.cgi?product=Websites&component=Bugzilla open a bug] in "Bugzilla" component of "Websites" product.

==== Administrators ====
You may also directly contact bugzilla admins, but we prefer that all requests are directed to the bugzilla itself as described above.

Bugzilla administration: [mailto:pavel.shved@rosalab.ru Pavel Shved]

Networking issues: [mailto:vladimir.mironov@rosalab.ru Vladimir Mironov]

=== For ROSA Employees ===

If you have problems with accessing bugzilla<ref>for instance, you get a "Server not found" error.</ref>, or wonder what e-mail and password to use, please, refer [https://corpwiki.rosalinux.ru/index.php/Bugzilla_%D0%B4%D0%BB%D1%8F_ROSA_Linux#.D0.94.D0.BE.D1.81.D1.82.D1.83.D0.BF here].

=== Notes ===

<references/>