Fixed Documentation - review code-block::python which force syntax highlighting

code-block:: python it forces the syntax highlighting even if there are errors so we only need it when the auto-syntax highlighting doesn't work and we can't or don't want to fix the example
At some place the PEP8 (2newlines) is respected and some isn't... my thoughts was to put forward good practices