fixes in the documentation and in class descriptions