docs(client): the big docstring refactor

This refactors the client docstrings such that they provide more useful information to the user. Please note that I also refactored how `clusters:create` is parsed as part of a nitpicking, but I can easily revert that if the change is unnecessary. This PR should be completely backwards compatible, save the `clusters:create` change.
This line is confusing - routers can move about the cluster. Can we change this to `Note: this requires wildcard DNS configuration on the domain` and then just link to the DNS doc?