Documentation improvements

In this minor release, documentation was greatly improved by @reachfh. More clear descriptions, precise statements and consistency.

Thanks ❤️