summaryrefslogtreecommitdiffstats
path: root/docs/sgml/administration.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/sgml/administration.sgml')
-rw-r--r--docs/sgml/administration.sgml97
1 files changed, 97 insertions, 0 deletions
diff --git a/docs/sgml/administration.sgml b/docs/sgml/administration.sgml
index 54f984fbc..98e726312 100644
--- a/docs/sgml/administration.sgml
+++ b/docs/sgml/administration.sgml
@@ -1192,6 +1192,103 @@
</para>
</listitem>
</orderedlist>
+ <para>
+ You may find this example illustrative for how bug groups work.
+ <example>
+ <title>Bugzilla Groups</title>
+ <literallayout>
+Bugzilla Groups example
+-----------------------
+
+For this example, let us suppose we have four groups, call them
+Group1, Group2, Group3, and Group4.
+
+We have 5 users, User1, User2, User3, User4, User5.
+
+We have 8 bugs, Bug1, ..., Bug8.
+
+Group membership is defined by this chart:
+(X denotes that user is in that group.)
+(I apologize for the nasty formatting of this table. Try viewing
+it in a text-based browser or something for now. -MPB)
+
+ G G G G
+ r r r r
+ o o o o
+ u u u u
+ p p p p
+ 1 2 3 4
+ +-+-+-+-+
+User1|X| | | |
+ +-+-+-+-+
+User2| |X| | |
+ +-+-+-+-+
+User3|X| |X| |
+ +-+-+-+-+
+User4|X|X|X| |
+ +-+-+-+-+
+User5| | | | |
+ +-+-+-+-+
+
+Bug restrictions are defined by this chart:
+(X denotes that bug is restricted to that group.)
+
+ G G G G
+ r r r r
+ o o o o
+ u u u u
+ p p p p
+ 1 2 3 4
+ +-+-+-+-+
+Bug1| | | | |
+ +-+-+-+-+
+Bug2| |X| | |
+ +-+-+-+-+
+Bug3| | |X| |
+ +-+-+-+-+
+Bug4| | | |X|
+ +-+-+-+-+
+Bug5|X|X| | |
+ +-+-+-+-+
+Bug6|X| |X| |
+ +-+-+-+-+
+Bug7|X|X|X| |
+ +-+-+-+-+
+Bug8|X|X|X|X|
+ +-+-+-+-+
+
+Who can see each bug?
+
+Bug1 has no group restrictions. Therefore, Bug1 can be seen by any
+user, whatever their group membership. This is going to be the only
+bug that User5 can see, because User5 isn't in any groups.
+
+Bug2 can be seen by anyone in Group2, that is User2 and User4.
+
+Bug3 can be seen by anyone in Group3, that is User3 and User4.
+
+Bug4 can be seen by anyone in Group4. Nobody is in Group4, so none of
+these users can see Bug4.
+
+Bug5 can be seen by anyone who is in _both_ Group1 and Group2. This
+is only User4. User1 cannot see it because he is not in Group2, and
+User2 cannot see it because she is not in Group1.
+
+Bug6 can be seen by anyone who is in both Group1 and Group3. This
+would include User3 and User4. Similar to Bug5, User1 cannot see Bug6
+because he is not in Group3.
+
+Bug7 can be seen by anyone who is in Group1, Group2, and Group3. This
+is only User4. All of the others are missing at least one of those
+group priveleges, and thus cannot see the bug.
+
+Bug8 can be seen by anyone who is in Group1, Group2, Group3, and
+Group4. There is nobody in all four of these groups, so nobody can
+see Bug8. It doesn't matter that User4 is in Group1, Group2, and
+Group3, since he isn't in Group4.
+ </literallayout>
+ </example>
+ </para>
</section>
</section>