Documentation updates for client usage

- Changed code examples to include usage of client connectors, and to take into account that ClientManager.createClient and ThriftClient<T>.open() return futures
- Added notes about client connectors, and how to make client calls asynchronous