Update documentation to align with current practices.

Update doc to discourage the use of `automatic_soa'.

Use Python 'code blocks' for coding examples.

Update some more files.

Mention that 'analyze_modules' is the way to go.

Update syntax.

Update docs according to Ali.