docs for #2
Merge pull request #3 from mafintosh/patch-1

docs for #2