revised docstring formatting for effects