Adding a bit more information in the documentation

There's much work that remains to be done on the documentation, but that should more or less do it for 0.3.

Closes #471.