Add javadoc strings to each of the user-facing Java classes, and reference those javadoc strings in the documentation on the Java client.
Expand discussion of the `close` function for clojure clients and the `close` method for Java clients. Add examples for making requests with various types of clients. Fix wording/typos.
Add some external API docs in the doc folder which detail how to make requests using the Java and clojure clients.