Added more clarification to docs
Merge pull request #383 from camilonova/patch-3

Added more clarification to docs