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.
I'd get rid of "the upcoming" here, it's implied by the [highly experimental]