docstring explained more
(#554)