Added a markdown README

1 files changed, 3 insertions, 5 deletions

diff --git a/documentation.rst b/documentation.rst
index 3c10cae..1fda579 100644
--- a/documentation.rst
+++ b/documentation.rst
@@ -957,9 +957,7 @@ you will get a ``NameError``:
 
 Finally, the implementation is such that the decorated function
 attribute ``.func_globals`` is a *copy* of the original function
-attribute. On the other hand the function attribute dictionary
-of the decorated function is just a reference to the
-original function dictionary, i.e. ``vars(decorated_f) is vars(f)``:
+attribute, just as the attribute dictionary of the decorated function.
 
 .. code-block:: python
 
@@ -972,8 +970,8 @@ original function dictionary, i.e. ``vars(decorated_f) is vars(f)``:
  >>> traced_f.attr1
  'something'
  >>> traced_f.attr2 = "something different"  # setting attr
- >>> f.attr2  # the original attribute did change
- 'something different'
+ >>> f.attr2  # the original attribute did not change
+ 'something else'
 
 Compatibility notes
 ---------------------------------------------------------------