some documentation improvements
Merge pull request #132 from bitovi/doc-improvements

some documentation improvements