added docstring
revised docstring in face of self-criticism
Merge pull request #1 from ngs-docs/docstring

Looks OK to me.