Cross refs for simplepolicies.py

zopefoundation · Sep 14, 2017 · f7b02bd · f7b02bd
1 parent 1d1aef0
commit f7b02bd
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 6 deletions.
diff --git a/docs/api/simplepolicies.rst b/docs/api/simplepolicies.rst
@@ -1,6 +1,5 @@
-:mod:`zope.security.simplepolicies`
-===================================
+==============================
+ zope.security.simplepolicies
+==============================
 
 .. automodule:: zope.security.simplepolicies
-   :members:
-   :member-order: bysource
diff --git a/src/zope/security/simplepolicies.py b/src/zope/security/simplepolicies.py
@@ -11,7 +11,13 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-"""Simple 'ISecurityPolicy' implementations.
+"""
+Simple :class:`zope.security.interfaces.ISecurityPolicy` implementations.
+
+As a reminder, ``ISecurityPolicy`` objects are factories for producing
+:class:`zope.security.interfaces.IInteraction` objects. That means
+that the classes themselves are implementations of
+``ISecurityPolicy``.
 """
 import zope.interface
 
@@ -25,7 +31,8 @@
 @zope.interface.provider(ISecurityPolicy)
 class ParanoidSecurityPolicy(object):
     """
-    Prohibit all access by any non-system principal, unless the item is public.
+    Prohibit all access by any non-system principal, unless the item
+    is :data:`public <zope.security.checker.CheckerPublic>`.
 
     This means that if there are no participations (and hence no
     principals), then access is allowed.