Refactoring docs

some additions to documentation.