BMO/Requesting Changes: Difference between revisions

no edit summary
m (added Category:BMO using HotCat)
No edit summary
 
(14 intermediate revisions by 4 users not shown)
Line 9: Line 9:
===Products===
===Products===


* The name of the product
* (required) The name of the product
* The [https://bugzilla.mozilla.org/enter_bug.cgi?full=1 classification] (group) you would like the product in
* (required) The [https://bugzilla.mozilla.org/enter_bug.cgi?full=1 classification] (group) you would like the product in
* A longer description, usually including a web link for more info on the product
* (required) A longer description, usually including a web link for more info on the product
* The initial list of components, with their info (see below)
* (required) The initial list of components, with their info (see [[BMO/Requesting_Changes#Components|below]])
* The initial list of versions, with their info (see below)
* (required) 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 initial list of target milestones, with their info (see below)
* (optional) A template (in markdown) for bugs in the new product (this can be overriden at the component level)
* 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)
* (optional) The initial list of versions, with their info (see [[BMO/Requesting_Changes#Versions|below]])
* The number of votes needed to confirm a bug (UNCO --> NEW) (optional, disabled by default)
* (optional) The initial list of target milestones, with their info (see [[BMO/Requesting_Changes#Target_Milestones|below]])
* If you want review requests to require a reviewer (optional, false by default)
* (optional) The number of votes needed to confirm a bug (UNCO --> NEW) (disabled by default)
* The list of [https://bugzilla.mozilla.org/page.cgi?id=review_suggestions.html suggested reviewers] for the review flag (optional, empty by default)
* (optional) If you want review requests to require a reviewer (false by default)
* The number of days until a review/needinfo/feedback is considered "overdue" and will trigger a reminder email (default 7 days)
* (optional) The list of [https://bugzilla.mozilla.org/page.cgi?id=review_suggestions.html suggested reviewers] for the review flag (empty by default)
* Any flags you want visible on the product (this can be per-component, or product-wide).
* (optional) The number of days until a review/needinfo/feedback is considered "overdue" and will trigger a reminder email (default 7 days)
* (optional) Any flags you want visible on the product (this can be per-component, or product-wide).


===Components===
===Components===


* The name of the component
* (required) The name of the component
* The product it should go in. When adding a component to Firefox, please CC gavin.sharp@gmail.com.
* (required) The product it should go in
* A longer description
* (required) A longer description
* Normally we default the assignee to be 'nobody@mozilla.org' but you can optionally set it to a specific individual
* (required) A [https://bugzilla.mozilla.org/page.cgi?id=triage_owners.html triage lead], responsible for [https://wiki.mozilla.org/Bugmasters/Process/Triage making decisions] on NEW bugs in the component (optional if not a Firefox component, but recommended)
* Normally the "QA Contact" is empty, but you can optionally set it to a specific individual
* (optional) A template (in markdown) for new bugs in the component. If this is specified, it will override the template for the parent product if one exists
* Any flags (bug and/or attachment) that will need to be visible for bugs against the new component
* (optional) It's highly recommended that the default assignee for new bugs is 'nobody@mozilla.org', however this can be changed if required
* The list of [https://bugzilla.mozilla.org/page.cgi?id=review_suggestions.html suggested reviewers] for the review flag (optional, uses the product's review suggestions by default)
* (optional) Normally the "QA Contact" is empty, but you can optionally set it to a specific individual
* (optional) Any flags (bug and/or attachment) that will need to be visible for bugs against the new component
 
Triage lead, QA contact, and recommended viewers should all be bugmail addresses, so check against Mozillians, Phonebook, or ask to make sure you have the right email.
 
===Bug Templates===
 
You can specify, at the product and component level, a template for new bugs. The template should be in Markdown and should ask for information and steps specific to the product or component.
 
If a product has a bug template, all new bugs in the product will display the template, unless the template is overridden at the component level.
 
If a component has a bug template, all new bugs in the component will display that template, overriding any product level components template.


===Versions===
===Versions===


* The name of the version
* (required) The name of the version
* The product it should go in
* (required) The product it should go in


===Target Milestones===
===Target Milestones===


* The name of the target milestone
* (required) The name of the target milestone
* The product it should go in
* (required) The product it should go in


===Custom Fields===
===Custom Fields===
Adding new custom fields is not something we can do easily, so we try to be careful about adding them.
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.  
They add more complexity to the UI, and carry an overhead for all bugs on the system, regardless of their visibility. 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
* (required) The name of the field
* A longer description
* (required) A longer description
* The type (Bug ID, Large Text Box, Free Text, Multiple Selection Box, Single Selection Box or Date/Time)
* (required) 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
* (required) The initial set of values, if Multiple or Single Selection Box
* The product(s) it should show up in
* (required) The product(s) it should show up in
* Whether it can be set on bug creation
* (required) Whether it can be set on bug creation


===Keywords===
===Keywords===


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.
Keywords are a faster and typo-free alternative to using whiteboard tags. In order to create one we'll need:


* The name of the keyword
* (required) The name of the keyword
* The description to use
* (required) The description to use
* A good reason why it should be added


===Additional Field Values===
===Additional Field Values===
Line 64: Line 75:
This could be Hardware or OS.
This could be Hardware or OS.


* The value to be added
* (required) The value to be added
* The field it should be added to
* (required) The field it should be added to


===Flags===
===Flags===


* The name of the flag
* (required) The name of the flag
* A longer description
* (required) A longer description
* Which products/components the flag should appear in
* (required) Which products/components the flag should appear in
* Whether the flag applies to bugs or attachments
* (required) 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)
* (required) 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
* (required) Whether the flag should be requested from a specific person
* Whether the flag can be set multiple times
* (required) Whether the flag can be set multiple times
* If flags of this type are requestable, the group allowed to request them, if any
* (optional) 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
* (optional) The group allowed to grant/deny flags of this type, if any
* CC list for request notifications, if any (all valid Bugzilla accounts)
* (optional) CC list for request notifications, if any (not recommended, use component watching)


===Users===
===Users===
Line 102: Line 113:


==Changes==
==Changes==
===Triage Owner===
To change a component's triage owner [https://bugzilla.mozilla.org/enter_bug.cgi?product=bugzilla.mozilla.org&component=Administration file a bug] with the details of the product, component, and new owner.  Note a triage owner must be an individual (not a group), and they won't automatically have access to security bugs filed in components.


===Changing Product, Component, Version or Milestone Name===
===Changing Product, Component, Version or Milestone Name===
Line 108: Line 123:


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.
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.
===


===Suggested Reviewers===
===Suggested Reviewers===
Line 124: Line 141:


Here's [[BMO/RetiringComponents|how to retire components and products]].
Here's [[BMO/RetiringComponents|how to retire components and products]].
===User Permissions===
For common user permissions, i.e. canconfirm and editbugs, please see the [instructions on BMO itself https://bugzilla.mozilla.org/page.cgi?id=get_permissions.html].  For other permissions, e.g. security groups, please file a confidential bug or contact the BMO team.


==Disablings==
==Disablings==
Confirmed users
1,201

edits