OkHttp has a bunch of docs:
- Marketing Site: what it is, basic examples, and download links.
- Design Overviews: high-level explanation on how things fit together.
- Recipes: executable sample code.
- Javadoc: reference docs.
The recipes are new. The contrast between recipes and Javadocs is interesting:
Javadocs show you how to call a method: what parameters are legal and what return values to expect.
And the recipe shows you why.