[SciPy-Dev] Clarification: is the Extended Summary section optional?
David Goldsmith
d.l.goldsmith@gmail....
Tue Jun 1 15:32:20 CDT 2010
The docstring Standard seems to be careful to note which sections are
considered optional, and the "Extended Summary" is *not* on that list.
However, I'm encountering many SciPy docstrings in the Wiki lacking this
section and yet marked as "Needs review": should I ignore this deficiency
and add a ticket to clarify the Standard, or should such docstrings be moved
back to "Being written"?
DG
--
Mathematician: noun, someone who disavows certainty when their uncertainty
set is non-empty, even if that set has measure zero.
Hope: noun, that delusive spirit which escaped Pandora's jar and, with her
lies, prevents mankind from committing a general suicide. (As interpreted
by Robert Graves)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/scipy-dev/attachments/20100601/aebc4d1a/attachment.html
More information about the SciPy-Dev
mailing list