doc changes
more clarification
Merge pull request #2 from unxmaal/master

Doc updates