JCLOUDS-457: Extend javadoc and add README.md

Added more javadoc documentation. This covers the basics of the
provider.
What does the last sentence mean? That you can't download the output for *all* jobs in the response? How do you know which ones are still accessible?