more doc updates
Merge pull request #23 from bodepd/doc_improvements

more doc updates