tweaking docs to fix link to wiki Keystone page

updated docstrings to remove two errors
reformatted front page header to be consistent
added links to autogenerated python documentation

Change-Id: I59fddc12ff458bbd0102a40d4d85903ab6bd6394

1 files changed, 8 insertions, 8 deletions

diff --git a/keystone/policy/backends/rules.py b/keystone/policy/backends/rules.py
index 92a90efa..c0df430e 100644
--- a/keystone/policy/backends/rules.py
+++ b/keystone/policy/backends/rules.py
@@ -79,20 +79,20 @@ def enforce(credentials, action, target):
     """Verifies that the action is valid on the target in this context.
 
        :param credentials: user credentials
-       :param action: string representing the action to be checked
-
-           this should be colon separated for clarity.
-           i.e. compute:create_instance
-                compute:attach_volume
-                volume:attach_volume
-
+       :param action: string representing the action to be checked, which
+                      should be colon separated for clarity.
        :param target: dictionary representing the object of the action
                       for object creation this should be a dictionary
                       representing the location of the object e.g.
                       {'tenant_id': object.tenant_id}
-
        :raises: `exception.Forbidden` if verification fails.
 
+       Actions should be colon separated for clarity. For example:
+
+        * compute:create_instance
+        * compute:attach_volume
+        * volume:attach_volume
+
     """
     init()