From a35c9866e37c8676238ca1ea272f917cf3e57f89 Mon Sep 17 00:00:00 2001 From: Gervase Markham Date: Fri, 13 May 2016 14:31:15 +0100 Subject: Rationalise lists of built-in groups and their capabilities into one correct list. r=dylan --- docs/en/rst/using/preferences.rst | 75 ++++++++++++++++++++++++--------------- 1 file changed, 47 insertions(+), 28 deletions(-) (limited to 'docs/en/rst/using') diff --git a/docs/en/rst/using/preferences.rst b/docs/en/rst/using/preferences.rst index d61dc4f8a..f0ffc5c1a 100644 --- a/docs/en/rst/using/preferences.rst +++ b/docs/en/rst/using/preferences.rst @@ -144,52 +144,71 @@ API key' section of the page. Permissions =========== -This is a purely informative page which outlines your current +This is an informational page which outlines your current permissions on this installation of Bugzilla. -A complete list of permissions in a default install of Bugzilla is below. -Your administrator may have defined other permissions. Only users with -*editusers* privileges can change the permissions of other users. +A complete list of available permissions in a default install of Bugzilla is +below. Your administrator may have defined other permissions. Only users with +the *editusers* permission can change the permissions of other users. admin - Indicates user is an Administrator. + User is an administrator, which (in normal circumstances) means they can + do anything. -bz_canusewhineatothers - Indicates user can configure whine reports for other users. - -bz_canusewhines - Indicates user can configure whine reports for self. - -bz_quip_moderators - Indicates user can moderate quips. +tweakparams + Permits user to change administration :ref:`Parameters `, and + to enable, disable and change the default value of + :ref:`General Preferences `. bz_sudoers - Indicates user can perform actions as other users. + Permits user to impersonate and perform actions as other users. This is + useful for admins to reproduce problems with Bugzilla, such as permissions + problems, that other users see. bz_sudo_protect - Indicates user cannot be impersonated by other users. - -canconfirm - Indicates user can confirm a bug or mark it a duplicate. + Indicates user cannot be impersonated by other users who have the + *bz_sudoers* permission. creategroups - Indicates user can create and destroy groups. - -editbugs - Indicates user can edit all bug fields. + Permits user to create, delete and edit permission groups. editclassifications - Indicates user can create, destroy and edit classifications. + Permits user to create, delete and edit classifications. editcomponents - Indicates user can create, destroy and edit products, components, + Permits user to create, delete and edit products, components, versions, milestones and flag types. + This capability can also be given on a per-product basis. + editkeywords - Indicates user can create, destroy and edit keywords. + Permits user to create, delete and edit keywords. editusers - Indicates user can create, disable and edit users. + Permits user to create, disable and edit users. -tweakparams - Indicates user can change :ref:`Parameters `. +canconfirm + Permits user to confirm a bug (move it from UNCONFIRMED to + another status). + + This permission is only used if you are using the UNCONFIRMED status in + any products. The *editbugs* permission implies this permission. + + This capability can also be given on a per-product basis. + +editbugs + Permits user to edit all fields on a bug. Without this permission, users + can only edit bugs where they are the reporter or the assignee, or add + comments. + + This capability can also be given on a per-product basis. + +bz_canusewhines + Permits user to configure whine reports to be sent to themselves. + +bz_canusewhineatothers + Permits user to configure whine reports to be sent to other users. + +bz_quip_moderators + Permits user to moderate the list of quips (pithy sayings at the top of + bug lists). -- cgit v1.2.3-24-g4f1b