clarify docs
Merge pull request #17 from cantino/clarify_docs

clarify docs