[doc] add some precisions in the doc
[mod] typo