updated/added method documentation