[Numpy-discussion] documenting optional out parameter
Mon Oct 26 00:51:40 CDT 2009
> 2009/10/26 Brent Pedersen <firstname.lastname@example.org>:
> hi, i've seen this section:
> should _all_ functions with an optional out parameter have exactly that text?
> so if i find a docstring with reasonable, but different doc for out,
> should it be changed
> to that?
The Q&A doesn't seem to have reached a firm conclusion, so I'd suggest
that any correct and reasonable documentation of the out parameter is
> and if a docstring of a function with an optional out that needs
> review does not have
> the out parameter documented should it be marked as 'Needs Work'?
I'd say yes, since the docstring is incomplete in this case.
More information about the NumPy-Discussion