Merge pull request #164 from lloydbenson/master

improve some issues with documentation