Reorganization of documentation

The main goal is to streamline the experience for "regular users"
Merge pull request #124 from JuliaLang/teh/docreorg

Reorganization of documentation