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
I like good practices but I'm also unsure about this give any gain on incomplete snippet. 
I will bend to your suggestion then