CLOUDIFY-1916 add some javadocs