Fixes #17 add some docs re client re-use