javadocs + cleanup  + refactoring
Signed-off-by:jonathanlermitage <jonathan.lermitage@gmail.com>