Improve docstrings

These were my suggestions in PR #216.
[pypi-skeleton] fix docs, posixpath->os.path

Improve documentation
Replace posixpath with more generic os.path
Merge pull request #219 from hashdist/pr216fix

Improve docstrings