Documentation update

Propositions for updating the documentation