[SciPy-dev] consistency for documenting mathematical functions in numpy.core.umath
Robert Kern
robert.kern at gmail.com
Wed Oct 21 23:33:18 EDT 2009
On Wed, Oct 21, 2009 at 22:05, Angel Yanguas-Gil
<angel.yanguas at gmail.com> wrote:
> Hi!
>
> I have noticed that the structure of the docstrings (sections, etc.)
> of the mathematical functions defined in numpy.core.umath change from
> function to function. Maybe it is an old topic but, would it be worth
> to unify them - i.e., using the same reference sources, same section
> structure, consistent cross-reference between methods etc. ?
The standard is here:
http://projects.scipy.org/numpy/browser/trunk/doc/HOWTO_DOCUMENT.txt
You can help fix nonconforming docstrings here:
http://docs.scipy.org/numpy/Front%20Page/
You may be looking at older versions. There has been substantial
effort put into improving this aspect of the docstrings recently.
--
Robert Kern
"I have come to believe that the whole world is an enigma, a harmless
enigma that is made terrible by our own mad attempt to interpret it as
though it had an underlying truth."
-- Umberto Eco
More information about the SciPy-Dev
mailing list