JCLOUDS-457: Extend javadoc and add README.md

Added more javadoc documentation. This covers the basics of the
provider.
[minor] "response includes"