improving docstrings for list.each#