updated the documentation
small fixes in methods descriptions