diff options
11 files changed, 97 insertions, 349 deletions
diff --git a/extensions/BMO/template/en/default/hook/global/user-error-error_message.html.tmpl b/extensions/BMO/template/en/default/hook/global/user-error-error_message.html.tmpl index c7fb31009..d5f0058ea 100644 --- a/extensions/BMO/template/en/default/hook/global/user-error-error_message.html.tmpl +++ b/extensions/BMO/template/en/default/hook/global/user-error-error_message.html.tmpl @@ -9,8 +9,8 @@ [% IF error == 'illegal_change' || error == 'illegal_change_deps' %] <p> If you are attempting to confirm an unconfirmed [% terms.bug %] or edit the - fields of a [% terms.bug %], <a href="page.cgi?id=get_permissions.html">find - out how to get the necessary permissions</a>. + fields of a [% terms.bug %], <a href="https://wiki.mozilla.org/BMO/UserGuide#Permissions_and_Groups"> + find out how to get the necessary permissions</a>. </p> [% END %] diff --git a/extensions/BMO/template/en/default/pages/get_permissions.html.tmpl b/extensions/BMO/template/en/default/pages/get_permissions.html.tmpl deleted file mode 100644 index c62286af3..000000000 --- a/extensions/BMO/template/en/default/pages/get_permissions.html.tmpl +++ /dev/null @@ -1,44 +0,0 @@ -[%# This Source Code Form is subject to the terms of the Mozilla Public - # License, v. 2.0. If a copy of the MPL was not distributed with this - # file, You can obtain one at http://mozilla.org/MPL/2.0/. - # - # This Source Code Form is "Incompatible With Secondary Licenses", as - # defined by the Mozilla Public License, v. 2.0. - #%] - -[% PROCESS global/header.html.tmpl - title = "Upgrade Permissions" -%] - -<h3>How to apply for upgraded permissions</h3> - -<p> - If you want <kbd>canconfirm</kbd>, you can add it yourself using - the <a href="page.cgi?id=triage_request.html">triage request form</a>. -</p> - -<p> - If you want <kbd>editbugs</kbd>, email <a href="mailto:bmo-perms@mozilla.org"> - bmo-perms@mozilla.org</a> either: - <ul> - <li> - The URLs of two [% terms.bugs %] to which you have attached patches - or testcases; or - </li> - <li> - The URLs of the relevant comment on three [% terms.bugs %] which you - wanted to change, but couldn't, and so added a comment instead. - </li> - </ul> -</p> - -<p> - <kbd>editbugs</kbd> implies <kbd>canconfirm</kbd>; there's no need to apply for both. -</p> - -<p> - Don't forget to include your [% terms.Bugzilla %] ID if it's not the email address - you are emailing from. -</p> - -[% PROCESS global/footer.html.tmpl %] diff --git a/extensions/BugModal/template/en/default/bug_modal/edit.html.tmpl b/extensions/BugModal/template/en/default/bug_modal/edit.html.tmpl index d81fb9e92..08a47b2d6 100644 --- a/extensions/BugModal/template/en/default/bug_modal/edit.html.tmpl +++ b/extensions/BugModal/template/en/default/bug_modal/edit.html.tmpl @@ -203,6 +203,7 @@ field_type = constants.FIELD_TYPE_FREETEXT hide_on_view = 1 short_width = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#alias" %] [%# summary %] @@ -210,6 +211,7 @@ field = bug_fields.short_desc field_type = constants.FIELD_TYPE_FREETEXT hide_on_view = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#short_desc" %] [%# status summary %] @@ -282,8 +284,8 @@ [%# buttons %] <div id="mode-container"> - [% IF user.id %] - <div> + <div> + [% IF user.id %] <button type="button" id="cancel-btn" class="minor" style="display:none">Cancel</button> <button type="button" id="mode-btn" class="major"> <span id="mode-btn-readonly" title="Enable editing fields for [% terms.bug %] metadata">Edit [% terms.Bug %]</span> @@ -293,8 +295,8 @@ </span> </button> <button type="submit" id="commit-btn" class="save-btn major" style="display:none">Save Changes</button> - </div> - [% END %] + [% END %] + </div> <div class="button-row"> [% IF bug.assigned_to.id == user.id || user.in_group("editbugs") %] <button type="button" id="copy-summary" class="minor" @@ -319,7 +321,9 @@ <hr> <menuitem id="action-history" label="History"></menuitem> </menu> - + </div> + <div id="user-guide"> + <a title="User guide for [% terms.Bugzilla %]" href="https://wiki.mozilla.org/BMO/UserGuide">Get help with this page</a> </div> </div> [% END %] @@ -339,12 +343,14 @@ [% WRAPPER fields_lhs %] [%# product %] - [% can_edit_product = bug.check_can_change_field("product", 0, 1) %] + [% can_edit_product = bug.check_can_change_field("product", 0, 1) %] + [% filtered_product = bug.product_obj.name FILTER uri %] + [% filtered_component = bug.component_obj.name FILTER uri %] [% WRAPPER bug_modal/field.html.tmpl field = bug_fields.product field_type = constants.FIELD_TYPE_SINGLE_SELECT hide_on_edit = can_edit_product - help = "describecomponents.cgi" + help = "describecomponents.cgi?product=$filtered_product" %] <span class="spin-latch" id="product-latch" data-latch="#product-latch" data-for="#product-info">▸</span> <div class="spin-toggle" data-latch="#product-latch" data-for="#product-info"> @@ -355,12 +361,12 @@ </div> [% END %] [% WRAPPER bug_modal/field.html.tmpl - field = bug_fields.product - field_type = constants.FIELD_TYPE_SINGLE_SELECT - hide_on_view = 1 - hide_on_edit = !can_edit_product + field = bug_fields.product + field_type = constants.FIELD_TYPE_SINGLE_SELECT + hide_on_view = 1 + hide_on_edit = !can_edit_product append_content = 1 - help = "describecomponents.cgi" + help = "describecomponents.cgi?product=$filtered_product" %] <span id="product-search-container"> [% INCLUDE prodcompsearch/form.html.tmpl @@ -380,9 +386,10 @@ [%# component %] [% WRAPPER bug_modal/field.html.tmpl - field = bug_fields.component + field = bug_fields.component field_type = constants.FIELD_TYPE_SINGLE_SELECT - help = "describecomponents.cgi" + help = "describecomponents.cgi?product=$filtered_product&component=$filtered_component#$filtered_component" + %] <span class="spin-latch" id="component-latch" data-latch="#component-latch" data-for="#component-info">▸</span> <div class="spin-toggle" data-latch="#component-latch" data-for="#component-info"> @@ -401,6 +408,7 @@ label = "Importance" container = 1 hide_on_view = bug.priority == "--" && bug.bug_severity == "normal" + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#priority" %] [% INCLUDE bug_modal/field.html.tmpl field = bug_fields.priority @@ -429,10 +437,11 @@ [%# status, resolution %] [% IF bug.assigned_to.id != user.id %] [% WRAPPER bug_modal/field.html.tmpl - name = "status-view" - container = 1 - label = "Status" + name = "status-view" + container = 1 + label = "Status" hide_on_edit = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugStatuses" %] [% bug.bug_status FILTER html %] [%+ bug.resolution FILTER html IF bug.resolution %] @@ -450,15 +459,17 @@ field = bug_fields.creation_ts label = "Reported" view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#creation_ts" %] [% INCLUDE bug_modal/rel_time.html.tmpl ts=bug.creation_ts %] [% END %] [%# last modified %] [% WRAPPER bug_modal/field.html.tmpl - field = bug_fields.delta_ts - label = "Modified" - view_only = 1 + field = bug_fields.delta_ts + label = "Modified" + view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#delta_ts" %] [% INCLUDE bug_modal/rel_time.html.tmpl ts=bug.delta_ts %] [% END %] @@ -467,10 +478,11 @@ [%# status/resolution knob %] [% WRAPPER bug_modal/field.html.tmpl - name = "status-edit" - container = 1 - label = "Status" + name = "status-edit" + container = 1 + label = "Status" hide_on_view = bug.assigned_to.id != user.id + help = "https://wiki.mozilla.org/BMO/UserGuide/BugStatuses" %] [% INCLUDE status_block %] [% END %] @@ -542,6 +554,7 @@ field = bug_fields.assigned_to field_type = constants.FIELD_TYPE_USER hide_on_edit = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#assigned_to" %] [% IF unassigned %] <i>Unassigned</i> @@ -563,6 +576,7 @@ } append_content = 1 default = bug.component_obj.default_assignee.login + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#assigned_to" %] <div class="set-default-container" style="display:none"> <input type="checkbox" id="set-default-assignee" name="set_default_assignee" class="set-default" @@ -579,6 +593,7 @@ label = "Mentors" value = bug.mentors.pluck("login") hide_on_view = bug.mentors.size == 0 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#bug_mentor" %] [% IF bug.mentors.size; @@ -597,6 +612,7 @@ field_type = constants.FIELD_TYPE_USER hide_on_view = bug.qa_contact == "" hide_on_edit = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#qa_contact" %] [% INCLUDE bug_modal/user.html.tmpl u=bug.qa_contact %] [% END %] @@ -606,6 +622,7 @@ hide_on_view = 1 append_content = 1 default = (bug.component_obj.default_qa_contact.id ? bug.component_obj.default_qa_contact.login : '') + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#qa_contact" %] <div class="set-default-container" style="display:none"> <input type="checkbox" id="set-default-qa-contact" name="set_default_qa_contact" class="set-default" @@ -622,6 +639,7 @@ field = bug_fields.reporter field_type = constants.FIELD_TYPE_USER view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#reporter" %] [%# triage owner %] @@ -630,9 +648,9 @@ field_type = constants.FIELD_TYPE_USER value = bug.component_obj.triage_owner view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#triage_owner" %] - [%# needinfo %] [% WRAPPER bug_modal/field.html.tmpl container = 1 @@ -650,6 +668,7 @@ container = 1 label = "NeedInfo" hide_on_view = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#needinfo" %] <button type="button" id="needinfo-scroll" class="minor">Update</button> [% END %] @@ -660,6 +679,7 @@ container = 1 label = "CC" hide_on_view = bug.cc.size == 0 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#cc" %] [% IF user.id %] @@ -742,6 +762,7 @@ [% INCLUDE bug_modal/field.html.tmpl field = bug_fields.version field_type = constants.FIELD_TYPE_SINGLE_SELECT + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#version" %] [%# milestone %] @@ -749,6 +770,7 @@ field = bug_fields.target_milestone field_type = constants.FIELD_TYPE_SINGLE_SELECT label = "Target" + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#target_milestone" %] [%# platform, op-sys %] @@ -757,6 +779,7 @@ label = "Platform" hide_on_view = (bug.rep_platform == 'All' && bug.op_sys == 'All') || (bug.rep_platform == 'Unspecified' && bug.op_sys == 'Unspecified') + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#rep_platform" %] [% INCLUDE bug_modal/field.html.tmpl field = bug_fields.rep_platform @@ -844,6 +867,7 @@ field_type = constants.FIELD_TYPE_BUG_LIST values = bug.depends_on_obj hide_on_view = bug.dependson.size == 0 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#dependson" %] [%# blocks %] @@ -852,6 +876,7 @@ field_type = constants.FIELD_TYPE_BUG_LIST values = bug.blocks_obj hide_on_view = bug.blocked.size == 0 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#blocks" %] [% IF bug.dependson.size + bug.blocked.size > 1 %] @@ -873,6 +898,7 @@ label = "Duplicates" values = bug.duplicates hide_on_edit = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#duplicates" %] [% END %] @@ -911,9 +937,10 @@ [% IF tracking_flags_has %] [%# tracking flags %] [% WRAPPER bug_modal/field.html.tmpl - container = 1 - label = "Tracking Flags" + container = 1 + label = "Tracking Flags" hide_on_view = !tracking_flags_set + help = "https://wiki.mozilla.org/BMO/UserGuide#Tracking_Flags" %] [% INCLUDE bug_modal/tracking_flags.html.tmpl type = "tracking" @@ -940,9 +967,10 @@ [% IF project_flags_has %] [%# project flags %] [% WRAPPER bug_modal/field.html.tmpl - container = 1 - label = "Project Flags" + container = 1 + label = "Project Flags" hide_on_view = !project_flags_set + help = "https://wiki.mozilla.org/BMO/UserGuide#Tracking_Flags" %] [% INCLUDE bug_modal/tracking_flags.html.tmpl type = "project" @@ -991,6 +1019,7 @@ [% WRAPPER bug_modal/field.html.tmpl container = 1 label = "Votes" + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#votes" %] [% bug.votes FILTER html %] vote[% "s" IF bug.votes != 1 %] @@ -1032,6 +1061,7 @@ field = bug_fields.bug_file_loc field_type = constants.FIELD_TYPE_FREETEXT hide_on_view = bug.bug_file_loc == "" + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#bug_file_loc" %] [% INCLUDE bug_url_link %] [% END %] @@ -1042,6 +1072,7 @@ field_type = constants.FIELD_TYPE_BUG_URLS values = bug.see_also hide_on_view = bug.see_also.size == 0 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#see_also" %] [% Hook.process('details_rhs') %] @@ -1133,12 +1164,14 @@ value = estimated_time hide_on_view = 0 short_width = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#estimated_time" %] [% current_estimate = PROCESS formattimeunit time_unit = (bug.actual_time + bug.remaining_time) %] [% INCLUDE bug_modal/field.html.tmpl label = "Current Est" value = current_estimate view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#current_estimate" %] [% hours_worked = PROCESS formattimeunit time_unit = bug.actual_time %] [% WRAPPER bug_modal/field.html.tmpl @@ -1147,6 +1180,7 @@ name = "work_time" value = '0.0' short_width = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#work_time" %] [% PROCESS formattimeunit time_unity = bug.actual_time %] [% END %] @@ -1156,6 +1190,7 @@ field_type = constants.FIELD_TYPE_FREETEXT value = hours_left short_width = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#remaining_time" %] [% END %] @@ -1165,17 +1200,20 @@ label = "% Complete" value = percentage_complete view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#percentage_complete" %] [% time_gain = PROCESS formattimeunit time_unit = bug.estimated_time - (bug.actual_time + bug.remaining_time) %] [% INCLUDE bug_modal/field.html.tmpl label = "Gain" value = time_gain view_only = 1 + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#gain" %] [% INCLUDE bug_modal/field.html.tmpl field = bug_fields.deadline field_type = constants.FIELD_TYPE_DATE value = bug.deadline + help = "https://wiki.mozilla.org/BMO/UserGuide/BugFields#deadline" %] <div> <a href="summarize_time.cgi?id=[% bug.bug_id FILTER none %]&do_depends=1"> diff --git a/extensions/BugModal/web/bug_modal.css b/extensions/BugModal/web/bug_modal.css index 338195acb..2ef56619e 100644 --- a/extensions/BugModal/web/bug_modal.css +++ b/extensions/BugModal/web/bug_modal.css @@ -970,3 +970,7 @@ div.ui-tooltip { z-index: 100; opacity: 0; } + +#user-guide { + padding-top: 5px; +} diff --git a/extensions/BugModal/web/bug_modal.js b/extensions/BugModal/web/bug_modal.js index 2a75d33d2..8d908873e 100644 --- a/extensions/BugModal/web/bug_modal.js +++ b/extensions/BugModal/web/bug_modal.js @@ -678,6 +678,13 @@ $(function() { window.location.replace($('#this-bug').val()); }); + // Open help page + $('#help-btn') + .click(function(event) { + event.preventDefault(); + window.open("https://wiki.mozilla.org/BMO/UserGuide", "_blank"); + }); + // needinfo in people section -> scroll to near-comment ui $('#needinfo-scroll') .click(function(event) { diff --git a/extensions/TrackingFlags/template/en/default/bug/tracking_flags.html.tmpl b/extensions/TrackingFlags/template/en/default/bug/tracking_flags.html.tmpl index efce91cfe..5881d1e6d 100644 --- a/extensions/TrackingFlags/template/en/default/bug/tracking_flags.html.tmpl +++ b/extensions/TrackingFlags/template/en/default/bug/tracking_flags.html.tmpl @@ -13,18 +13,8 @@ <tr id="row_[% flag.name FILTER html %]"> <td [% IF new_bug %]class="field_label"[% END %]> <label for="[% flag.name FILTER html %]"> - [% IF new_bug %] - <a - [% IF help_html.${flag.name}.defined %] - title="[% help_html.${flag.name} FILTER txt FILTER collapse FILTER html %]" - class="field_help_link" - [% END %] - href="page.cgi?id=fields.html#[% flag.name FILTER uri %]"> - [% END %] - [% flag.description FILTER html %] - [% IF new_bug %] - </a> - [% END %]:</label> + [% flag.description FILTER html %]: + </label> </td> <td> [% IF user.id %] diff --git a/extensions/TrackingFlags/template/en/default/hook/bug/create/create-bug_flags.html.tmpl b/extensions/TrackingFlags/template/en/default/hook/bug/create/create-bug_flags.html.tmpl index b41e1619f..6e7014f01 100644 --- a/extensions/TrackingFlags/template/en/default/hook/bug/create/create-bug_flags.html.tmpl +++ b/extensions/TrackingFlags/template/en/default/hook/bug/create/create-bug_flags.html.tmpl @@ -8,6 +8,10 @@ [% RETURN IF NOT tracking_flags.size %] <td> + <div> + <a href="https://wiki.mozilla.org/BMO/UserGuide#Tracking_Flags" target="_blank"> + What do these flags mean?</a> + </div> <table class="tracking_flags"> [% FOREACH type = tracking_flag_types %] [% flag_list = [] %] diff --git a/template/en/default/bug/edit.html.tmpl b/template/en/default/bug/edit.html.tmpl index 2d0286292..164602ff2 100644 --- a/template/en/default/bug/edit.html.tmpl +++ b/template/en/default/bug/edit.html.tmpl @@ -142,7 +142,7 @@ <tr> <td colspan="2"> <span style="float:left"> - <a href="page.cgi?id=fields.html">What do these fields mean?</a> + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields">What do these fields mean?</a> </span> [% PROCESS commit_button id="_top"%] </td> @@ -384,7 +384,7 @@ [% BLOCK section_status %] <tr> <th class="field_label"> - <a href="page.cgi?id=fields.html#status">Status</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#bug_status">Status</a>: </th> <td id="bz_field_status"> <span id="static_bug_status"> @@ -443,7 +443,7 @@ <tr> <th class="field_label"> <label for="priority" accesskey="i"> - <a href="page.cgi?id=fields.html#importance"><u>I</u>mportance</a></label>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#importance"><u>I</u>mportance</a></label> </th> <td> [% INCLUDE bug/field.html.tmpl @@ -462,7 +462,7 @@ <tr> <th class="field_label"> <label for="target_milestone"> - <a href="page.cgi?id=fields.html#target_milestone"> + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#target_milestone"> Target Milestone</a></label>: </th> [% PROCESS select selname = "target_milestone" %] @@ -479,7 +479,7 @@ <tr> <th class="field_label"> - <a href="page.cgi?id=fields.html#assigned_to">Assigned To</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#assigned_to">Assigned To</a>: </th> <td> [% IF bug.check_can_change_field("assigned_to", 0, 1) %] @@ -579,7 +579,7 @@ <tr> <th class="field_label"> <label for="triage_owner"> - <a href="page.cgi?id=fields.html#triage_owner"> + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#triage_owner"> Triage Owner</a></label>: </th> <td> @@ -1218,7 +1218,7 @@ class="status" cellspacing="0" cellpadding="0"> <tr> <th class="field_label"> - <a href="page.cgi?id=fields.html#status">Status</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#bug_status">Status</a>: </th> <td> [% PROCESS bug/knob.html.tmpl %] diff --git a/template/en/default/bug/field-label.html.tmpl b/template/en/default/bug/field-label.html.tmpl index ecb49318e..94180fabc 100644 --- a/template/en/default/bug/field-label.html.tmpl +++ b/template/en/default/bug/field-label.html.tmpl @@ -45,7 +45,7 @@ [% IF desc_url %] href="[% desc_url FILTER html %]" [% ELSE %] - href="page.cgi?id=fields.html#[% field.name FILTER uri %]" + href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#[% field.name FILTER uri %]" [% END %] >[%- field_descs.${field.name} FILTER html %]:</a> diff --git a/template/en/default/list/edit-multiple.html.tmpl b/template/en/default/list/edit-multiple.html.tmpl index 8a1de5f2d..58d02839c 100644 --- a/template/en/default/list/edit-multiple.html.tmpl +++ b/template/en/default/list/edit-multiple.html.tmpl @@ -84,7 +84,7 @@ <th> <label for="priority"> - <a href="page.cgi?id=fields.html#priority">Priority</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#priority">Priority</a>: </label> </th> <td> @@ -97,7 +97,7 @@ <th> <label for="rep_platform"> - <a href="page.cgi?id=fields.html#rep_platform">Platform</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#rep_platform">Platform</a>: </label> </th> <td> @@ -107,7 +107,7 @@ <th> <label for="bug_severity"> - <a href="page.cgi?id=fields.html#bug_severity">Severity</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#bug_severity">Severity</a>: </label> </th> <td> @@ -120,7 +120,7 @@ <tr> <th> <label for="op_sys"> - <a href="page.cgi?id=fields.html#op_sys">OS</a>: + <a href="https://wiki.mozilla.org/BMO/UserGuide/BugFields#op_sys">OS</a>: </label> </th> <td [% " colspan=\"3\"" IF !Param("usetargetmilestone") %]> diff --git a/template/en/default/pages/fields.html.tmpl b/template/en/default/pages/fields.html.tmpl deleted file mode 100644 index 8c763d73f..000000000 --- a/template/en/default/pages/fields.html.tmpl +++ /dev/null @@ -1,251 +0,0 @@ -[%# The contents of this file are subject to the Mozilla Public - # License Version 1.1 (the "License"); you may not use this file - # except in compliance with the License. You may obtain a copy of - # the License at http://www.mozilla.org/MPL/ - # - # Software distributed under the License is distributed on an "AS - # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or - # implied. See the License for the specific language governing - # rights and limitations under the License. - # - # The Original Code is the Bugzilla Bug Tracking System. - # - # The Initial Developer of the Original Code is Netscape Communications - # Corporation. Portions created by Netscape are - # Copyright (C) 1998 Netscape Communications Corporation. All - # Rights Reserved. - # - # Contributor(s): Terry Weissman <terry@mozilla.org> - # Gervase Markham <gerv@gerv.net> - #%] - -[% PROCESS "global/field-descs.none.tmpl" %] -[% PROCESS global/header.html.tmpl - title = "$terms.Bug Fields" - style_urls = ['skins/standard/page.css'] -%] - -<p>This page describes the various fields that you see - on [% terms.abug %].</p> - -<table class="field_value_explanation"> - <thead> - <tr> - <td id="bug_status"> - <h2>[% field_descs.bug_status FILTER upper FILTER html %]</h2> - </td> - - <td id="resolution"> - <h2>[% field_descs.resolution FILTER upper FILTER html %]</h2> - </td> - </tr> - - <tr> - <td>The [% field_descs.bug_status FILTER html %] field indicates the - current state of a [% terms.bug %]. Only certain status transitions - are allowed.</td> - - <td>The [% field_descs.resolution FILTER html %] field indicates what - happened to this [%+ terms.bug %].</td> - </tr> - </thead> - - <tbody> - <tr class="header_row"> - <td colspan="2">Open [% terms.Bugs %]</td> - </tr> - <tr> - <td> - <dl> - <dt class="unconfirmed"> - [% display_value("bug_status", "UNCONFIRMED") FILTER html %] - </dt> - <dd class="unconfirmed"> - This [% terms.bug %] has recently been added to the database. - Nobody has validated that this [% terms.bug %] is true. Users - who have the "canconfirm" permission set may confirm - this [% terms.bug %], changing its state to [% display_value("bug_status", "NEW") FILTER html %]. Or, it may be - directly resolved and marked [% display_value("bug_status", "RESOLVED") FILTER html %]. - </dd> - <dt> - <b>[% display_value("bug_status", "NEW") FILTER html %]</b> - </dt> - <dd> - This [% terms.bug %] has recently been added to the assignee's - list of [% terms.bugs %] and must be processed. [% terms.Bugs %] in - this state may be accepted, and become <b>[% display_value("bug_status", "ASSIGNED") FILTER html %]</b>, passed - on to someone else, and remain <b>[% display_value("bug_status", "NEW") FILTER html %]</b>, or resolved and marked - <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>. - </dd> - - <dt> - <b>[% display_value("bug_status", "ASSIGNED") FILTER html %]</b> - </dt> - <dd> - This [% terms.bug %] is not yet resolved, but is assigned to the - proper person. From here [% terms.bugs %] can be given to another - person and become <b>[% display_value("bug_status", "NEW") FILTER html %]</b>, or - resolved and become <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>. - </dd> - - <dt> - <b>[% display_value("bug_status", "REOPENED") FILTER html %]</b> - </dt> - <dd> - This [% terms.bug %] was once resolved, but the resolution was - deemed incorrect. For example, a <b>[% display_value("resolution", "WORKSFORME") FILTER html %]</b> [% terms.bug %] is - <b>[% display_value("bug_status", "REOPENED") FILTER html %]</b> when more information shows up and - the [% terms.bug %] is now reproducible. From here [% terms.bugs %] are - either marked <b>[% display_value("bug_status", "ASSIGNED") FILTER html %]</b> or - <b>[% display_value("bug_status", "RESOLVED") FILTER html %]</b>. - </dd> - - [% Hook.process('open-status') %] - </dl> - </td> - - <td> - No resolution yet. All [% terms.bugs %] which are in one of - these "open" states have no resolution set. - </td> - </tr> - - <tr class="header_row"> - <td colspan="2">Closed [% terms.Bugs %]</td> - </tr> - - <tr> - <td> - <dl> - <dt class="resolved"> - [% display_value("bug_status", "RESOLVED") FILTER html %] - </dt> - <dd class="resolved"> - A resolution has been performed, and it is awaiting verification by - QA. From here [% terms.bugs %] are either reopened and given some - open status, or are verified by QA and marked - <b>[% display_value("bug_status", "VERIFIED") FILTER html %]</b>. - </dd> - - <dt class="verified"> - [% display_value("bug_status", "VERIFIED") FILTER html %] - </dt> - <dd class="verified"> - QA has looked at the [% terms.bug %] and the resolution and - agrees that the appropriate resolution has been taken. - Any zombie [% terms.bugs %] who choose to walk the earth again must - do so by becoming <b>[% display_value("bug_status", "REOPENED") FILTER html %]</b>. - </dd> - - [% Hook.process('closed-status') %] - </dl> - </td> - - <td> - <dl> - <dt class="fixed"> - [% display_value("resolution", "FIXED") FILTER html %] - </dt> - <dd class="fixed"> - A fix for this [% terms.bug %] is checked into the tree and - tested. - </dd> - - <dt class="invalid"> - [% display_value("resolution", "INVALID") FILTER html %] - </dt> - <dd class="invalid"> - The problem described is not [% terms.abug %]. - </dd> - - <dt class="wontfix"> - [% display_value("resolution", "WONTFIX") FILTER html %] - </dt> - <dd class="wontfix"> - The problem described is [% terms.abug %] which will never be - fixed. - </dd> - - <dt class="duplicate"> - [% display_value("resolution", "DUPLICATE") FILTER html %] - </dt> - <dd class="duplicate"> - The problem is a duplicate of an existing [% terms.bug %]. - Marking [% terms.abug %] duplicate requires the [% terms.bug %]# - of the duplicating [% terms.bug %] and will at least put - that [% terms.bug %] number in the description field. - </dd> - - <dt class="worksforme"> - [% display_value("resolution", "WORKSFORME") FILTER html %] - </dt> - <dd class="worksforme"> - All attempts at reproducing this [% terms.bug %] were futile, - and reading the code produces no clues as to why the described - behavior would occur. If more information appears later, - the [% terms.bug %] can be reopened. - </dd> - - [% Hook.process('resolution') %] - </dl> - </td> - </tr> - </tbody> -</table> - -<h2>Other Fields</h2> - -[% SET field_help_map = {} %] -[% FOREACH field = bug_fields.keys %] - [% SET field_desc = field_descs.$field %] - [% field_help_map.$field_desc = { help => help_html.$field, - field => field } %] -[% END %] - -[%# This field is not a real one, but its label is visible in bugs. %] - -[% field_help_map.Importance = { help => help_html.importance, - field => "importance" } %] - -[%# These are fields that don't need to be documented, either because - # they have docs somewhere else in the UI, or they don't show up on bugs. - # %] -[% SET skip_fields = [ - 'days_elapsed', - 'everconfirmed', - 'reporter_accessible', - 'cclist_accessible', - 'bug_group', - 'commenter', - 'owner_idle_time', - 'bug_status', - 'resolution', - 'assignee_last_login', -] %] - -<dl class="field_descriptions"> -[% FOREACH field_desc = field_help_map.keys.sort %] - [% SET field = field_help_map.${field_desc}.field %] - [% SET field_object = bug_fields.$field %] - - [% NEXT IF field_object.obsolete %] - [% NEXT IF !user.is_timetracker AND field_object.is_timetracking %] - - [% NEXT IF field == 'status_whiteboard' AND !Param('usestatuswhiteboard') %] - [% NEXT IF field == 'target_milestone' AND !Param('usetargetmilestone') %] - [% NEXT IF field == 'alias' AND !Param('usebugaliases') %] - - [%# For now we don't have help for attachment fields and so on. %] - [% NEXT IF field.match('\.') %] - - [% NEXT IF skip_fields.contains(field) %] - - <dt id="[% field FILTER html %]">[% field_desc FILTER html %]</dt> - <dd> - [% SET help_text = field_help_map.${field_desc}.help %] - [% help_text FILTER none %] - </dd> -[% END %] -</dl> - -[% PROCESS global/footer.html.tmpl %] |