469186 - Inconsistent documentation for 'useentrygroupdefault'.

Status: RESOLVED WONTFIX

(Bugzilla :: Documentation, defect)

Description

[Jason Cipriani]

User-Agent:       Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4 (.NET CLR 3.5.30729)
Build Identifier: 3.0.5

Documentation for useentrygroupdefault in user manual is correct and informative:

http://www.bugzilla.org/docs/2.18/html/parameters.html

"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."

However, description of useentrygroupdefault on the Group Security configuration page is vague and unhelpful:

"If this is on, Bugzilla will use product bug groups by default to restrict who can enter bugs. If this is on, users can see any product to which they have entry access in search menus. If this is off, users can see any product to which they have not been excluded by a mandatory restriction."

That description mentions search menus, mandatory restriction, and a few other things that don't seem to be (at least directly) related to this feature. The documentation in the user manual clearly explains what the option does, the documentation on the parameters page does not.

Solution is to update the parameters page description to match the one from the manual.

Note that I appear to be using a pretty old version of Bugzilla. I do not have the ability to update, unfortunately. I'm not sure if any of this documentation was clarified in newer versions.


Reproducible: Always

Steps to Reproduce:
1.
2.
3.

Comment 1

[Marc Schumann [:Wurblzap]]

This parameter is currently in the process of being removed by bug 478972.

Comment 2

[Frédéric Buclin]

(In reply to comment #1)
> This parameter is currently in the process of being removed by bug 478972.

Correct, and I don't think we will fix it on branches -> WONTFIX.