Reorganize the documentation

Will close issue #257 and #273 
Nice happy message - I love it!