Improve docs

[nsfinkelstein]

i) Document the raise_errors option
ii) Build docs from docstrings and create a read the docs site.