textual improvments of the documentation