A couple of corrections and clarifications in docs.
Merge pull request #3 from dragos/docs/corrections

A couple of corrections and clarifications in docs.