Improvements to documentation

[Tracking bug 22690]

[git-p4: depot-paths = "//depot/software/bioinformatics/lib/python/pbcore/": change = 121798]