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
In the docs, I'd prefer not to follow PEP8 with regard to 2 newlines above class names, etc. since most of our examples aren't complete code that's meant to be copy/pasted.