added method docs