This page details the information you need to provide in order to get speedy resolution to requests to change the configuration of bugzilla.mozilla.org. The BMO administration team aims to turn around all correctly-specified requests in 1 business day, however some changes made take longer (due to development effort required).
In general, the more significant a change you want to make, the more likely it is that you will need to provide evidence of discussion and consensus around the change.
- 1 Additions
- 2 Changes
- 3 Disablings
- 4 Deletions
File a bug, providing:
- The name of the product
- The classification (group) you would like the product in
- A longer description, usually including a web link for more info on the product
- The initial list of components, with their info (see below)
- The initial list of versions, with their info (see below)
- The initial list of target milestones, with their info (see below)
- The security group(s) bugs should be classified under when a user checks the security flag (if you don't know, we can help figure this out for you)
- The number of votes needed to confirm a bug (UNCO --> NEW) (optional, disabled by default)
- If you want review requests to require a reviewer (optional, false by default)
- The list of suggested reviewers for the review flag (optional, empty by default)
- The number of days until a review/needinfo/feedback is considered "overdue" and will trigger a reminder email (default 7 days)
- Any flags you want visible on the product (this can be per-component, or product-wide).
- The name of the component
- The product it should go in. When adding a component to Firefox, please CC firstname.lastname@example.org.
- A longer description
- Normally we default the assignee to be 'email@example.com' but you can optionally set it to a specific individual
- Normally the "QA Contact" is empty, but you can optionally set it to a specific individual
- Any flags (bug and/or attachment) that will need to be visible for bugs against the new component
- The list of suggested reviewers for the review flag (optional, uses the product's review suggestions by default)
- The name of the version
- The product it should go in
- The name of the target milestone
- The product it should go in
Adding new custom fields is not something we can do easily, so we try to be careful about adding them. Adding one requires running a script on the live server by an IT admin and is may cause downtime of BMO itself. They also add more complexity to the UI. You'll need to make your case before a custom field can be added. Generally, if a custom field is very specific to one niche area and do not concern the Project as a whole, we encourage the use of status whiteboard markers or other existing fields.
- The name of the field
- A longer description
- The type (Bug ID, Large Text Box, Free Text, Multiple Selection Box, Single Selection Box or Date/Time)
- The initial set of values, if Multiple or Single Selection Box
- The product(s) it should show up in
- Whether it can be set on bug creation
Keywords exist across all of Bugzilla, so we try to be careful about adding them. You'll need to make your case before a keyword can be added. Generally, if a keyword is very specific to one niche area and do not concern the Project as a whole, we encourage the use of status whiteboard markers.
- The name of the keyword
- The description to use
- A good reason why it should be added
Additional Field Values
This could be Hardware or OS.
- The value to be added
- The field it should be added to
- The name of the flag
- A longer description
- Which products/components the flag should appear in
- Whether the flag applies to bugs or attachments
- Whether the flag is requestable (i.e. users can ask for flags of this type to be set)
- Whether the flag should be requested from a specific person
- Whether the flag can be set multiple times
- If flags of this type are requestable, the group allowed to request them, if any
- The group allowed to grant/deny flags of this type, if any
- CC list for request notifications, if any (all valid Bugzilla accounts)
Users can sign up for accounts themselves.
Statuses and Resolutions
Changing the Bugzilla workflow is a big deal, and is very unlikely to happen without serious discussion. If you don't know whether you are authorised to make this sort of change, you aren't.
- Security groups are rarely granted explicitly into. Normally the groups membership is determined by inheritance from other groups.
- Most security groups have a related "-team" group that is used for actually granting people into. For example, no one is in the 'client-services-security' group directly. There is a 'client-services-security-team' group which is a member of the 'client-services-security' group. The individual users are placed directly into the 'client-services-security-team' group when needed. Therefore they get access to the other group as well through inheritance. Only the 'client-services-security' group should be actually visible on the bug report.
- Name for the new group.
- Which products need to have the new group enabled.
- Whether a specific account or mailing list should be automatically cc'ed when a bug is placed in the new group (optional).
- List of users to be placed in the new team group initially.
- Who should be the admin for the new group (bless rights) that will be able place others in the team group (optional).
Changing Product, Component, Version or Milestone Name
Bugzilla uses integer mappings internally for mapping IDs to human readable names such as Product, Component, etc. But when creating store queries in the form of a URL or when specifying a product to file a bug against, it doesn't use the ID, it uses the name. When a textual name is changed in BMO using the admin UI to something else, Bugzilla continues to work properly as it still uses the same ID everywhere internally and in the database. But if a stored query or a URL has been passed around to others via a wiki page, mailing list, etc. then the URL will no longer be valid. Users will need to update their queries and revise and relevant documentation to reflect the name change. Bugzilla, and BMO for that matter, does not support aliasing of the new name to any old names so that the old queries will continue to work. BMO admins will try harder to remind requesters that these issues may arise when making these types of name changes.
Note that this also affects BzAPI or the newer native REST API in that you will need to update the search parameters for bug searches to reflect the name changes as well.
A curated list of users can be suggested when the review flag is set for a patch, to aid new contributors in picking a reviewer. These suggested reviewers can be set globally for a product, or on a per-component basis. For the current list of users, see the suggested reviewers report.
Usernames and Passwords
Users can change their own username (email address) or password in the preferences. Changing your own email address is greatly preferred to creating a new account and then asking for a merge. If you have already created a new account but have not yet used it, then change its username to something bogus (i.e. abandon it), and change the username on your old account to the new one.
If you do need two accounts merged, and both have activity you don't want to lose, you will need to file a bug (see above).
Retiring Products and Components
Products and components aren't deleted from Bugzilla, since the records of their bugs or the work done on them may be useful. Instead, usually they are changed to disable the creation of new bugs in their category. They can also be moved to a "Graveyard" area.
Email firstname.lastname@example.org giving sufficient evidence of violation of Mozilla policies or community norms.
Old target milestones are normally disabled by the team at some point after the release has happened. This means that they can't be selected on bugs (although they will continue to show up if that's the current value) and you have to use the Boolean Charts to search for them.
Things in Bugzilla rarely get deleted. Many things can be disabled (see above) instead. You should not expect deletions to happen fast. It's probably best to file a bug explaining what you need deleted and why, and expect questions.
If you add an attachment and then realise it contains confidential or personal information, file a bug and it can be manually annulled. (The attachment links and name will remain, but the data will be removed.)
We don't delete accounts because that would be messing with the historical record. However, users can disable all their bug mail in their preferences if they would like to stop hearing from Bugzilla, and they may change their email address to an inactive or throwaway one if they wish.