Removed the "Python API" document in favor of the "Clients" doc

This change moves some docs into class docstrings and some into the
clients/index.rst document.

Fixes #6705