slight improvements in user docs
Merge pull request #166 from bodepd/update_user_docs

slight improvements in user docs