From 6c7d67b033a17eaaa551adbc9cdc9ad098a2bc59 Mon Sep 17 00:00:00 2001
From: Michele Simionato <michele.simionato@gmail.com>
Date: Sun, 15 Apr 2018 14:44:35 +0200
Subject: Updated docs [skip CI]

---
 docs/tests.documentation.rst | 35 +++++++++++++++++++----------------
 1 file changed, 19 insertions(+), 16 deletions(-)

(limited to 'docs')

diff --git a/docs/tests.documentation.rst b/docs/tests.documentation.rst
index c6d606c..e69cfa2 100644
--- a/docs/tests.documentation.rst
+++ b/docs/tests.documentation.rst
@@ -555,7 +555,25 @@ available. For instance:
  some data
 
 Decorator factories are most useful to framework builders. Here is an example
-that gives an idea of how you could manage permissions in a Web framework:
+that gives an idea of how you could manage permissions in a framework:
+
+.. code-block:: python
+
+ class Action(object):
+     @restricted(User)
+     def view(self):
+         "Any user can view objects"
+ 
+     @restricted(PowerUser)
+     def insert(self):
+         "Only power users can insert objects"
+ 
+     @restricted(Admin)
+     def delete(self):
+         "Only the admin can delete objects"
+
+
+where `restricted` is a decorator factory defined as follows
 
 .. code-block:: python
 
@@ -570,21 +588,6 @@ that gives an idea of how you could manage permissions in a Web framework:
              '%s does not have the permission to run %s!'
              % (self.user, func.__name__))
 
-.. code-block:: python
-
- class Action(object):
-     @restricted(User)
-     def view(self):
-         pass
- 
-     @restricted(PowerUser)
-     def insert(self):
-         pass
- 
-     @restricted(Admin)
-     def delete(self):
-         pass
-
 
 ``decorator(cls)``
 --------------------------------------------
-- 
cgit v1.2.1