Generally improve docs

[jackromo]

When html version of docs built, result is generally of poor quality. Must be improved in consistency, structure and formatting. Examples and more descriptions advised.

[jackromo]

All documentation should be changed to Google docstring format as well.