JCLOUDS-457: Extend javadoc and add README.md

Added more javadoc documentation. This covers the basics of the
provider.
[minor] Do we need to explain what happens to the existing parts? I would guess they are all dropped and nothing is stored? If that is correct, do we feel that is self-evident?