Doc fixes

[jverzani]

The docs here could use some love:

• hosting on gh-pages.
• some reorganization, landing page is not the tutorial, not should it be...

[money8203]

@jverzani I can help with organizing and handling of the docs!

[jverzani]

That's great. I was literally just working on some of this. Let me push what I have and then hand the keys over. I haven't set up the hosting through gh-pages yet, so that needs doing along with a general review.

[jverzani]

I just pushed #506 once it passes CI, I'll merge in.

[money8203]

Awesome, I'll take that

[jverzani]

There are a few lines in the introduction.md changes that are causing issues with doctests that I didn't see locally. If you want me to adjust, let me know. Otherwise, I'll let you carry on.

[money8203]

Sure you can fix that and then I'll start improving the docs

[jverzani]

All fixed with #508