Update documentation.

Closes #1, closes #2 and closes #3.