methods fn + updateded docs