improved client documentation
Merge pull request #914 from crate/h/client-docs

improved client docs