making improvements suggested by Preethi
Merge pull request #1200 from pulp/mhrivnak-doc-updates-from-preethi

making improvements suggested by Preethi