updated method descriptions