Skip to content

bugzilla
bugzilla
Commit b4056d08 authored by bugreport%peshkin.net's avatar bugreport%peshkin.net
Browse files
Options

Bug 178230 Update documentation for Entrprise Groups

r=Jake,preed a=justdave
parent f9605ef4
Show whitespace changes
Inline Side-by-side
Showing with 156 additions and 110 deletions
docs/sgml/administration.sgml
View file @ b4056d08
...@@ -38,27 +38,24 @@ ...@@ -38,27 +38,24 @@
<step> <step>
<para> <para>
<command>usebuggroups</command>: <command>makeproductgroups</command>:
This dictates whether or not to implement group-based security for This dictates whether or not to automatically create groups
Bugzilla. If set, Bugzilla bugs can have an associated 'group', when new products are created.
defining which users are allowed to see and edit the </para>
bug.</para>
<para>Set "usebuggroups" to "on"
<emphasis>only</emphasis>
if you may wish to restrict access to particular bugs to certain
groups of users. I suggest leaving
this parameter <emphasis>off</emphasis>
while initially testing your Bugzilla.</para>
</step> </step>
<step> <step>
<para> <para>
<command>usebuggroupsentry</command>: <command>useentrygroupdefault</command>:
Bugzilla Products can have a group associated with them, so that Bugzilla products can have a group associated with them, so that
certain users can only see bugs in certain products. When this parameter certain users can only see bugs in certain products. When this
is set to <quote>on</quote>, this places all newly-created bugs in the parameter is set to <quote>on</quote>, this
group for their product immediately.</para> 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.</para>
</step> </step>
<step> <step>
...@@ -648,44 +645,83 @@ ...@@ -648,44 +645,83 @@
<para>Groups allow the administrator <para>Groups allow the administrator
to isolate bugs or products that should only be seen by certain people. 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 <quote>Edit Group Controls.</quote>
</para>
<para>
If the makeproductgroups param is on, a new group will be automatically
created for every new product.
</para> </para>
<para> <para>
Product-Based Groups are matched with products, and allow you to restrict On the product edit page, there is a page to edit the
access to bugs on a per-product basis. They are enabled using the <quote>Group Controls</quote>
usebuggroups Param. Turning on the usebuggroupsentry for a product and determine which groups are applicable, default,
Param will mean bugs automatically get added to their product group when and mandatory for each product as well as controlling entry
filed. for each product and being able to set bugs in a product to be
totally read-only unless some group restrictions are met.
</para> </para>
<para> <para>
Generic Groups have no special relationship to products; For each group, it is possible to specify if membership in that
you create them, and put bugs in them group is...
as required. One example of the use of Generic Groups </para>
is Mozilla's "Security" group, <orderedlist>
into which security-sensitive bugs are placed until fixed. Only the <listitem>
Mozilla Security Team are members of this group. <para>
required for bug entry,
</para>
</listitem>
<listitem>
<para>
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).
</para>
</listitem>
<listitem>
<para>
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).
</para> </para>
</listitem>
<listitem>
<para>
required in order to make <emphasis>any</emphasis> change
to bugs in this product <emphasis>including comments.</emphasis>
</para>
</listitem>
</orderedlist>
<para>To create Generic Groups:</para> <para>To create Groups:</para>
<orderedlist> <orderedlist>
<listitem> <listitem>
<para>Select the "groups" <para>Select the <quote>groups</quote>
link in the footer.</para> link in the footer.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Take a moment to understand the instructions on the "Edit <para>Take a moment to understand the instructions on the <quote>Edit
Groups" screen, then select the "Add Group" link.</para> Groups</quote> screen, then select the <quote>Add Group</quote> link.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Fill out the "Group", "Description", and <para>Fill out the <quote>Group</quote>, <quote>Description</quote>,
"User RegExp" fields. "New User RegExp" allows you to automatically and <quote>User RegExp</quote> fields.
<quote>User RegExp</quote> allows you to automatically
place all users who fulfill the Regular Expression into the new group. place all users who fulfill the Regular Expression into the new group.
When you have finished, click "Add".</para> When you have finished, click <quote>Add</quote>.</para>
<warning> <warning>
<para>The User Regexp is a perl regexp and, if not anchored, will match <para>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 any part of an address. So, if you do not want to grant access
...@@ -701,28 +737,15 @@ ...@@ -701,28 +737,15 @@
</listitem> </listitem>
</orderedlist> </orderedlist>
<para>To use Product-Based Groups:</para>
<orderedlist>
<listitem>
<para>Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit
Parameters" screen.</para>
</listitem>
<listitem>
<para>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.</para>
</listitem>
</orderedlist>
<para> <para>
Note that group permissions are such that you need to be a member Note that group permissions are such that you need to be a member
of <emphasis>all</emphasis> the groups a bug is in, for whatever of <emphasis>all</emphasis> 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 <emphasis>all</emphasis> of the entry groups for a product
to add bugs to a product and you must be a member
of <emphasis>all</emphasis> of the canedit groups for a product
in order to make <emphasis>any</emphasis> change to bugs in that
product.
</para> </para>
</section> </section>
......
docs/xml/administration.xml
View file @ b4056d08
...@@ -38,27 +38,24 @@ ...@@ -38,27 +38,24 @@
<step> <step>
<para> <para>
<command>usebuggroups</command>: <command>makeproductgroups</command>:
This dictates whether or not to implement group-based security for This dictates whether or not to automatically create groups
Bugzilla. If set, Bugzilla bugs can have an associated 'group', when new products are created.
defining which users are allowed to see and edit the </para>
bug.</para>
<para>Set "usebuggroups" to "on"
<emphasis>only</emphasis>
if you may wish to restrict access to particular bugs to certain
groups of users. I suggest leaving
this parameter <emphasis>off</emphasis>
while initially testing your Bugzilla.</para>
</step> </step>
<step> <step>
<para> <para>
<command>usebuggroupsentry</command>: <command>useentrygroupdefault</command>:
Bugzilla Products can have a group associated with them, so that Bugzilla products can have a group associated with them, so that
certain users can only see bugs in certain products. When this parameter certain users can only see bugs in certain products. When this
is set to <quote>on</quote>, this places all newly-created bugs in the parameter is set to <quote>on</quote>, this
group for their product immediately.</para> 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.</para>
</step> </step>
<step> <step>
...@@ -648,44 +645,83 @@ ...@@ -648,44 +645,83 @@
<para>Groups allow the administrator <para>Groups allow the administrator
to isolate bugs or products that should only be seen by certain people. 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 <quote>Edit Group Controls.</quote>
</para>
<para>
If the makeproductgroups param is on, a new group will be automatically
created for every new product.
</para> </para>
<para> <para>
Product-Based Groups are matched with products, and allow you to restrict On the product edit page, there is a page to edit the
access to bugs on a per-product basis. They are enabled using the <quote>Group Controls</quote>
usebuggroups Param. Turning on the usebuggroupsentry for a product and determine which groups are applicable, default,
Param will mean bugs automatically get added to their product group when and mandatory for each product as well as controlling entry
filed. for each product and being able to set bugs in a product to be
totally read-only unless some group restrictions are met.
</para> </para>
<para> <para>
Generic Groups have no special relationship to products; For each group, it is possible to specify if membership in that
you create them, and put bugs in them group is...
as required. One example of the use of Generic Groups </para>
is Mozilla's "Security" group, <orderedlist>
into which security-sensitive bugs are placed until fixed. Only the <listitem>
Mozilla Security Team are members of this group. <para>
required for bug entry,
</para>
</listitem>
<listitem>
<para>
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).
</para>
</listitem>
<listitem>
<para>
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).
</para> </para>
</listitem>
<listitem>
<para>
required in order to make <emphasis>any</emphasis> change
to bugs in this product <emphasis>including comments.</emphasis>
</para>
</listitem>
</orderedlist>
<para>To create Generic Groups:</para> <para>To create Groups:</para>
<orderedlist> <orderedlist>
<listitem> <listitem>
<para>Select the "groups" <para>Select the <quote>groups</quote>
link in the footer.</para> link in the footer.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Take a moment to understand the instructions on the "Edit <para>Take a moment to understand the instructions on the <quote>Edit
Groups" screen, then select the "Add Group" link.</para> Groups</quote> screen, then select the <quote>Add Group</quote> link.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Fill out the "Group", "Description", and <para>Fill out the <quote>Group</quote>, <quote>Description</quote>,
"User RegExp" fields. "New User RegExp" allows you to automatically and <quote>User RegExp</quote> fields.
<quote>User RegExp</quote> allows you to automatically
place all users who fulfill the Regular Expression into the new group. place all users who fulfill the Regular Expression into the new group.
When you have finished, click "Add".</para> When you have finished, click <quote>Add</quote>.</para>
<warning> <warning>
<para>The User Regexp is a perl regexp and, if not anchored, will match <para>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 any part of an address. So, if you do not want to grant access
...@@ -701,28 +737,15 @@ ...@@ -701,28 +737,15 @@
</listitem> </listitem>
</orderedlist> </orderedlist>
<para>To use Product-Based Groups:</para>
<orderedlist>
<listitem>
<para>Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit
Parameters" screen.</para>
</listitem>
<listitem>
<para>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.</para>
</listitem>
</orderedlist>
<para> <para>
Note that group permissions are such that you need to be a member Note that group permissions are such that you need to be a member
of <emphasis>all</emphasis> the groups a bug is in, for whatever of <emphasis>all</emphasis> 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 <emphasis>all</emphasis> of the entry groups for a product
to add bugs to a product and you must be a member
of <emphasis>all</emphasis> of the canedit groups for a product
in order to make <emphasis>any</emphasis> change to bugs in that
product.
</para> </para>
</section> </section>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment