added descriptions of the methods of their parameters and returns the result