improved documentation
Merge pull request #32 from pfraze/32-imprv-docs

review and update documentation