Docs changes based on Melih's tech review comments.
Minor docs comments corrections.
Merge pull request #2 from jeffswartz/jira/10984b

Docs changes based on Melih's tech review comments