docs(client): the big docstring refactor

This refactors the docstrings such that they provide more useful
information to the user.