Reorganize the documentation

Will close issue #257 and #273 
you've got the tick in the wrong spot :)