fixes in the documentation and methods descriptions