Improve docstrings

These were my suggestions in PR #216.