Clarified and extended documentation

This pull requests does the following:

- Fix Sphinx generation
- Set up intersphinx with Flask
- Fix typos in the documentation
- Extend the documentation

I hope this helps for the upcoming 0.6 release. Let me know if there are things that need to be changed in this pull request.