Melhorando a documentacao

Como sugerido pela @Dayof
Corrigindo comentarios e gerando Javadoc

Esse commit, miss @Dayof , é para você xD