JavaDocs update

Signed-off-by: stephane brossier <sbrossier@groupon.com>