Bug 1563868 - update documentation for searching on bugs by group restriction

diff --git a/docs/en/rst/using/finding.rst b/docs/en/rst/using/finding.rst
index 4f81177c3f4898d2ca728e9128f9e2b4e1af4f7a..71ab9ec4ff8ec1eb7af5fadf07b2725a21399250 100644 (file)
--- a/docs/en/rst/using/finding.rst
+++ b/docs/en/rst/using/finding.rst
@@ -192,6 +192,26 @@ So if you are looking for bugs reported by any user being in the
 
     reporter   equals   "%group.editbugs%"
 
+.. _group_restrictions:
+
+Searching for Bugs Restricted to Groups
+---------------------------------------
+
+When administrators set up products, they can establish one or more 
+groups bugs in the product can be associated with. If a bug is associated
+with a group then only users who are members of the group can see them. 
+
+This restriction is mostly used for security-related bugs, or internal tickets.
+
+In order to search for bugs restricted to a group, you must be a member of the group. 
+
+Visit `the Permissions page <https://bugzilla.mozilla.org/userprefs.cgi?tab=permissions>`_ 
+to find the groups you belong to, then search using the clause
+
+    Group   is equal to "%group.groupname%"
+    
+to list the bugs restricted to `groupname`.
+
 .. _relative-dates:
 
 Searching on Relative Dates