update narrative docs about iterable decorator argument