Adding documentation so that the Javadocs are more useful

Perhaps an example user agent would be good here? Or more explanation for what you'd use it for?