203869 - Update documentation on group controls

Status: RESOLVED FIXED

(Bugzilla :: Documentation, defect, P3)

Description

[Joel Peshkin]

Comment 1

[Joel Peshkin]

Attachment: New Groups security stuff

Comment 2

[Dave Miller [:justdave]]

Enhancements which don't currently have patches on them which are targetted at
2.18 are being retargetted to 2.20 because we're about to freeze for 2.18. 
Consideration will be taken for moving items back to 2.18 on a case-by-case
basis (but is unlikely for enhancements)

Comment 3

[Gervase Markham [:gerv]]

I'd say this is a fairly major doc bug. And it has a patch.

Gerv

Comment 4

[Dave Miller [:justdave]]

Preliminarily moving all docs bugs to 2.18, we should make a valiant attempt to
have the docs as up-to-date as possible when 2.18 releases.

Comment 5

[Gervase Markham [:gerv]]

> Otherwise, the group can still be used to organize groups of users without 
> being used to control access to bugs.

You need to be more specific here. What sort of thing does this mean?

+      On the product edit page, there is a page to edit the 
+      <quote>Group Controls</quote> 
+      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. 

This is a pretty horrible sentence... Why not just say:

On the product edit page, there is a link to edit the Group Controls for a
product. This allows you to configure how a group relates to a particular
product, in a number of different ways. <list them>

If there are cases where a user can check a group and click commit, thereby
hiding the bug from themselves, you need to explain that.

> inacessable
> relevent

Typos.

This is all OK so far as it goes, but the whole thing is still really hard to
understand. It's also not clear why groups are so closely linked to products -
this needs some explanation. I, for one, when I came up with a groups use
scenario for a company, just wanted to isolate groups of people from one another
without regard to the product concerned, and couldn't figure out how to do that.

Gerv

Comment 6

[Joel Peshkin]

Attachment: v2 including Gerv's comments

OK, this addresses Gerv's comments.

There is a lot more that could be said about this topic, but that is a
different bug.

Comment 7

[Gervase Markham [:gerv]]

Comment on attachment 144203 [details] [diff] [review]
v2 including Gerv's comments

r=gerv.

Gerv

Comment 8

[Joel Peshkin]

Checked in

Comment 9

[Joel Peshkin]

*** Bug 228645 has been marked as a duplicate of this bug. ***