Task/documentation

####Reviewers 
@jframos @flopezag 
####Description
refine doc acording to comments
####Tests
tested locally.