Consistent syntax highlighting.
Decorators
----------
-Python language provides a simple yet powerful syntax called 'decorators'.
+The Python language provides a simple yet powerful syntax called 'decorators'.
A decorator is a function or a class that wraps (or decorate) a function
or a method. The 'decorated' function or method will replace the original
-'undecorated' function or method. Because function are first-class objects
+'undecorated' function or method. Because functions are first-class objects
in Python it can be done 'manually' but using the @decorator syntax is
-clearer and thus prefered.
+clearer and thus preferred.
- .. code-block:: Python
+ .. code-block:: python
def foo():
# do something