finish adding client support for Service object api
clean up the client docs a lot