restructure documentation
some more reshuffling
add more documentation
also document to_string
Merge branch 'restructured-docs'