Right now the API is very hard to understand and use.
I am especially confused about the error handling part when thrift server returns exceptions.
The examples shows very limited use case.

Can you write some doc similar to http://tchannel-python.readthedocs.io/en/latest/
Maybe start with at least JavaDoc