Refactor docs

[mkborregaard]

Richard, could you take a look at whether you are OK with me taking the docs this way? Maybe we could just merge all these tomorrow, then you can judge by looking at the docs -they this is of course in principle WIP. I'd like to move forward with this in preparation of the course.

[mkborregaard]

I've kept all of your text except the bit where you say that the only thing this package really cares about is Diversity.jl

[richardreeve]

Again, the errors seem to be from the grandparent, so apart from the routes.md issue above I think this is good to merge too.

[richardreeve]

@mkborregaard So, do you want to just delete those routes-that-aren't routes and merge this to reduce the complexity of the PR chain?

[mkborregaard]

Yeah I've actually done everything you asked but something seems to have gone wrong during the rebases. However the final version works, so let me just merge.

[coveralls]

Pull Request Test Coverage Report for Build 1341950236

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+2.003%) to 58.81%

---

Totals
Change from base Build 1341944170:	2.003%
Covered Lines:	1275
Relevant Lines:	2168

---

💛 - Coveralls