improved method descriptions