Documentation improvements

Reference issue

Closes #1 (closed)

What does this implement or fix?

Improves the documentation:

• add clearer instructions on how to install with pip
• update README and documentation landing page