Results of the Documentation sprint

This is a PR to merge the feature branch from the documentation sprint into master. There are a few things that are blocking this and they are listed below.

ToDo:

- [ ] Complete the API docs (Stuart)
- [ ] Spell check, all eye on please!