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
we should use pycon actually