deep refactor of documentation

deep refactor of documentation
Merge pull request #169 from simboss/master

Documentation Review for Master