DOC: add ssh examples to README.md; more docstrings; refactor rst docs