updates method descriptions