DOC: Update How should I format my code? section
DOC: Reorganize to make PEP8 more evident

It should be immediately clear that we follow PEP8 conventions for
variable, function, module, namings, etc.
DOC/BUG: Fix RST directives to render code