Doc typo
implement most of the corrections in the doc proposed by Dr Sauleau