Docs refactor

[Blendify]

Fix #557 see individual commits for details

[ericholscher]

I'd like to see more copy on the docs index page, not just a TOC. Also would be good to figure out how to stop the title from displaying in the sidebar (eg. http://sphinx-rtd-theme.readthedocs.io/en/docs-refactor/installing.html)

[ericholscher]

Big +1 on splitting up the content into multiple pages though. This makes a lot of sense, just needs a bit more cleanup on the landing page. I don't want to make people click GitHub -> RTD -> TOC to get any real info.

[Blendify]

@ericholscher

Also would be good to figure out how to stop the title from displaying in the sidebar (eg. http://sphinx-rtd-theme.readthedocs.io/en/docs-refactor/installing.html)

What do you mean exactly about the title in the sidebar? Do you want all these docs under one collapsible heading?

This makes a lot of sense, just needs a bit more cleanup on the landing page. I don't want to make people click GitHub -> RTD -> TOC to get any real info.

What do you mean by real info? What about including the readme file before the toctree?

[ericholscher]

• Remove the "Read the Docs Sphinx Theme" , or the logo, from the sidebar. It looks weird with both.

• Including the readme above the TOC would be a good start. That way we only have that info in one place.

[Blendify]

Addressed the review points. It looks really good now. So glad I got around to this. BTW with the PR #535 becomes obsolete.

[ericholscher]

Looks great. 👍