updated links to Docker API
minor wording tweaks in javadoc