fixes in some methods descriptions
updated the documentation