updated Javadocs + minor code refactorings
Signed-off-by:jonathanlermitage <jonathan.lermitage@gmail.com>