minior updates (method descriptions)