From 626f9d38a56a29b45be0f8665cd4c1f74ac22ec5 Mon Sep 17 00:00:00 2001 From: "bugreport%peshkin.net" Date: Mon, 30 Dec 2002 22:15:21 +0000 Subject: [PATCH] Bug 178230 Update documentation for Entrprise Groups r=Jake,preed a=justdave --- .../bugzilla/docs/sgml/administration.sgml | 133 ++++++++++-------- webtools/bugzilla/docs/xml/administration.xml | 133 ++++++++++-------- 2 files changed, 156 insertions(+), 110 deletions(-) diff --git a/webtools/bugzilla/docs/sgml/administration.sgml b/webtools/bugzilla/docs/sgml/administration.sgml index 847527203e0..b09de7666c5 100644 --- a/webtools/bugzilla/docs/sgml/administration.sgml +++ b/webtools/bugzilla/docs/sgml/administration.sgml @@ -38,27 +38,24 @@ - usebuggroups: - This dictates whether or not to implement group-based security for - Bugzilla. If set, Bugzilla bugs can have an associated 'group', - defining which users are allowed to see and edit the - bug. - - Set "usebuggroups" to "on" - only - if you may wish to restrict access to particular bugs to certain - groups of users. I suggest leaving - this parameter off - while initially testing your Bugzilla. + makeproductgroups: + This dictates whether or not to automatically create groups + when new products are created. + - usebuggroupsentry: - Bugzilla Products can have a group associated with them, so that - certain users can only see bugs in certain products. When this parameter - is set to on, this places all newly-created bugs in the - group for their product immediately. + useentrygroupdefault: + Bugzilla products can have a group associated with them, so that + certain users can only see bugs in certain products. When this + parameter is set to on, this + causes the initial group controls on newly created products + to place all newly-created bugs in the group + having the same name as the product immediately. + After a product is initially created, the group controls + can be further adjusted without interference by + this mechanism. @@ -648,44 +645,83 @@ Groups allow the administrator to isolate bugs or products that should only be seen by certain people. - There are two types of group - Generic Groups, and Product-Based Groups. + The association between products and groups is controlled from + the product edit page under Edit Group Controls. + + + + If the makeproductgroups param is on, a new group will be automatically + created for every new product. - Product-Based Groups are matched with products, and allow you to restrict - access to bugs on a per-product basis. They are enabled using the - usebuggroups Param. Turning on the usebuggroupsentry - Param will mean bugs automatically get added to their product group when - filed. + On the product edit page, there is a page to edit the + Group Controls + for a product and determine which groups are applicable, default, + and mandatory for each product as well as controlling entry + for each product and being able to set bugs in a product to be + totally read-only unless some group restrictions are met. - Generic Groups have no special relationship to products; - you create them, and put bugs in them - as required. One example of the use of Generic Groups - is Mozilla's "Security" group, - into which security-sensitive bugs are placed until fixed. Only the - Mozilla Security Team are members of this group. + For each group, it is possible to specify if membership in that + group is... + + + + required for bug entry, + + + + + Not applicable to this product(NA), + a possible restriction for a member of the + group to place on a bug in this product(Shown), + a default restriction for a member of the + group to place on a bug in this product(Default), + or a mandatory restriction to be placed on bugs + in this product(Mandatory). + + + + + Not applicable by non-members to this product(NA), + a possible restriction for a non-member of the + group to place on a bug in this product(Shown), + a default restriction for a non-member of the + group to place on a bug in this product(Default), + or a mandatory restriction to be placed on bugs + in this product when entered by a non-member(Mandatory). + + + + + required in order to make any change + to bugs in this product including comments. + + + - To create Generic Groups: + To create Groups: - Select the "groups" + Select the groups link in the footer. - Take a moment to understand the instructions on the "Edit - Groups" screen, then select the "Add Group" link. + Take a moment to understand the instructions on the Edit + Groups screen, then select the Add Group link. - Fill out the "Group", "Description", and - "User RegExp" fields. "New User RegExp" allows you to automatically + Fill out the Group, Description, + and User RegExp fields. + User RegExp allows you to automatically place all users who fulfill the Regular Expression into the new group. - When you have finished, click "Add". + When you have finished, click Add. The User Regexp is a perl regexp and, if not anchored, will match any part of an address. So, if you do not want to grant access @@ -701,28 +737,15 @@ - To use Product-Based Groups: - - - - Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit - Parameters" screen. - - - - - In future, when you create a Product, a matching group will be - automatically created. If you need to add a Product Group to - a Product which was created before you turned on usebuggroups, - then simply create a new group, as outlined above, with the - same name as the Product. - - - Note that group permissions are such that you need to be a member of all the groups a bug is in, for whatever - reason, to see that bug. + reason, to see that bug. Similarly, you must be a member + of all of the entry groups for a product + to add bugs to a product and you must be a member + of all of the canedit groups for a product + in order to make any change to bugs in that + product. diff --git a/webtools/bugzilla/docs/xml/administration.xml b/webtools/bugzilla/docs/xml/administration.xml index 847527203e0..b09de7666c5 100644 --- a/webtools/bugzilla/docs/xml/administration.xml +++ b/webtools/bugzilla/docs/xml/administration.xml @@ -38,27 +38,24 @@ - usebuggroups: - This dictates whether or not to implement group-based security for - Bugzilla. If set, Bugzilla bugs can have an associated 'group', - defining which users are allowed to see and edit the - bug. - - Set "usebuggroups" to "on" - only - if you may wish to restrict access to particular bugs to certain - groups of users. I suggest leaving - this parameter off - while initially testing your Bugzilla. + makeproductgroups: + This dictates whether or not to automatically create groups + when new products are created. + - usebuggroupsentry: - Bugzilla Products can have a group associated with them, so that - certain users can only see bugs in certain products. When this parameter - is set to on, this places all newly-created bugs in the - group for their product immediately. + useentrygroupdefault: + Bugzilla products can have a group associated with them, so that + certain users can only see bugs in certain products. When this + parameter is set to on, this + causes the initial group controls on newly created products + to place all newly-created bugs in the group + having the same name as the product immediately. + After a product is initially created, the group controls + can be further adjusted without interference by + this mechanism. @@ -648,44 +645,83 @@ Groups allow the administrator to isolate bugs or products that should only be seen by certain people. - There are two types of group - Generic Groups, and Product-Based Groups. + The association between products and groups is controlled from + the product edit page under Edit Group Controls. + + + + If the makeproductgroups param is on, a new group will be automatically + created for every new product. - Product-Based Groups are matched with products, and allow you to restrict - access to bugs on a per-product basis. They are enabled using the - usebuggroups Param. Turning on the usebuggroupsentry - Param will mean bugs automatically get added to their product group when - filed. + On the product edit page, there is a page to edit the + Group Controls + for a product and determine which groups are applicable, default, + and mandatory for each product as well as controlling entry + for each product and being able to set bugs in a product to be + totally read-only unless some group restrictions are met. - Generic Groups have no special relationship to products; - you create them, and put bugs in them - as required. One example of the use of Generic Groups - is Mozilla's "Security" group, - into which security-sensitive bugs are placed until fixed. Only the - Mozilla Security Team are members of this group. + For each group, it is possible to specify if membership in that + group is... + + + + required for bug entry, + + + + + Not applicable to this product(NA), + a possible restriction for a member of the + group to place on a bug in this product(Shown), + a default restriction for a member of the + group to place on a bug in this product(Default), + or a mandatory restriction to be placed on bugs + in this product(Mandatory). + + + + + Not applicable by non-members to this product(NA), + a possible restriction for a non-member of the + group to place on a bug in this product(Shown), + a default restriction for a non-member of the + group to place on a bug in this product(Default), + or a mandatory restriction to be placed on bugs + in this product when entered by a non-member(Mandatory). + + + + + required in order to make any change + to bugs in this product including comments. + + + - To create Generic Groups: + To create Groups: - Select the "groups" + Select the groups link in the footer. - Take a moment to understand the instructions on the "Edit - Groups" screen, then select the "Add Group" link. + Take a moment to understand the instructions on the Edit + Groups screen, then select the Add Group link. - Fill out the "Group", "Description", and - "User RegExp" fields. "New User RegExp" allows you to automatically + Fill out the Group, Description, + and User RegExp fields. + User RegExp allows you to automatically place all users who fulfill the Regular Expression into the new group. - When you have finished, click "Add". + When you have finished, click Add. The User Regexp is a perl regexp and, if not anchored, will match any part of an address. So, if you do not want to grant access @@ -701,28 +737,15 @@ - To use Product-Based Groups: - - - - Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit - Parameters" screen. - - - - - In future, when you create a Product, a matching group will be - automatically created. If you need to add a Product Group to - a Product which was created before you turned on usebuggroups, - then simply create a new group, as outlined above, with the - same name as the Product. - - - Note that group permissions are such that you need to be a member of all the groups a bug is in, for whatever - reason, to see that bug. + reason, to see that bug. Similarly, you must be a member + of all of the entry groups for a product + to add bugs to a product and you must be a member + of all of the canedit groups for a product + in order to make any change to bugs in that + product.