(TK-117) Add external API docs

Add some external API docs in the doc folder which detail how
to make requests using the Java and clojure clients.
There's unfortunately no javadocs for any of our classes in `clj-http-client`. I agree that we should add them. I can add them in this PR, or we can open another ticket for it.