Clarify and expand docstrings.

[byronnlandry]

Problem

Current plans to automate Python client documentation generation consume client docstrings. Some of these strings are currently incomplete or unclear.

Solution

This PR expands and clarifies the docstrings in the Python client.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update
• Infrastructure change (CI configs, etc)
• [x ] Non-code change (docs, etc)
• None of the above: (explain here)