#changes for the doc

adding comments on attributes and méthods
and other cleaning