Pyobjects documentation improvements

This makes a simple enhancement to the module documentation for
pyobjects and also updates inline comments throughout the renderer.
Merge pull request #10831 from borgstrom/develop

Pyobjects documentation improvements