[Numpy-discussion] merging docs from wiki

David Goldsmith d.l.goldsmith@gmail....
Tue Sep 22 15:33:15 CDT 2009


On Sun, Sep 20, 2009 at 12:49 PM, Ralf Gommers
<ralf.gommers@googlemail.com>wrote:

> Hi,
>
> I'm done reviewing all the improved docstrings for NumPy, they can be
> merged now from the doc editor Patch page. Maybe I'll get around to doing
> the SciPy ones as well this week, but I can't promise that.
>

Thank you very much, Ralf!

There are a few docstrings on the Patch page I did not mark "Ok to apply":
>
> 1. the generic docstrings. Some are marked Ready for review, but they refer
> mostly to "self" and to "generic" which I don't think is very helpful. It
> would be great if someone could do just one of those docstrings and make it
> somewhat informative.


I couldn't agree more; unfortunately, I've been trying, highly
unsuccessfully, to get someone to do this for a while - I promoted them in
the hopes that a reviewer saying they needed an expert's eye would be more
authoritative - I guess we're about to find out if that's the case. ;-)

DG


> There are about 50 that can then be done in the same way.
>

> 2. get_numpy_include: the docstring is deleted because the function is
> deprecated. I don't think that is helpful but I'm not sure. Should this be
> reverted or applied?
>
> Cheers,
> Ralf
>
>
> _______________________________________________
> NumPy-Discussion mailing list
> NumPy-Discussion@scipy.org
> http://mail.scipy.org/mailman/listinfo/numpy-discussion
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/numpy-discussion/attachments/20090922/4ac934a1/attachment.html 


More information about the NumPy-Discussion mailing list