controller: Add controller client documentation.

Not sure all of these are detailed enough.
> Close closes the underlying transport connection.