Two Marathon questions
0) Are there any Category Leaders who do *not* want help finishing their categories? 1) Is there anyone "in-the-know" who feels that reading "numpy-docs/reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings? But for the masked array categories and the uncategorized docstrings, we're pretty close! DG
On Aug 5, 2009, at 1:33 PM, David Goldsmith wrote:
0) Are there any Category Leaders who do *not* want help finishing their categories?
1) Is there anyone "in-the-know" who feels that reading "numpy-docs/ reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings?
Mmh. Can't really tell. Experience with masked arrays is certainly a prerequisite, but one shouldn't need to be an expert. Nevertheless, I'd be obliged if anybody willing to edit the MA docstrings could contact me beforehand w/ questions.
On Wed, Aug 5, 2009 at 2:59 PM, Pierre GM <pgmdevlist@gmail.com> wrote:
On Aug 5, 2009, at 1:33 PM, David Goldsmith wrote:
0) Are there any Category Leaders who do *not* want help finishing their categories?
1) Is there anyone "in-the-know" who feels that reading "numpy-docs/ reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings?
Mmh. Can't really tell. Experience with masked arrays is certainly a prerequisite, but one shouldn't need to be an expert. Nevertheless, I'd be obliged if anybody willing to edit the MA docstrings could contact me beforehand w/ questions.
Pierre, I did a lot of the MA docstrings over the past few days. I would appreciate it if you could look at some of those (see http://docs.scipy.org/numpy/changes/ for recent changes) and let me know if there's anything that you think should be done differently. I also moved a lot of the private functions/classes to Unimportant status, but I did fix the markup for a lot of them and added some Parameters sections etc where I thought it was helpful. Again, please let me know if you have any recommendations. Cheers, Ralf
_______________________________________________ Scipy-dev mailing list Scipy-dev@scipy.org http://mail.scipy.org/mailman/listinfo/scipy-dev
Thanks for your reply, Pierre. --- On Wed, 8/5/09, Pierre GM <pgmdevlist@gmail.com> wrote:
On Aug 5, 2009, at 1:33 PM, David Goldsmith wrote:
1) Is there anyone "in-the-know" who feels that reading "numpy-docs/ reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings?
Mmh. Can't really tell. Experience with masked arrays is certainly a prerequisite, but one shouldn't need to be an expert. Nevertheless, I'd be obliged if anybody willing to edit the MA docstrings could contact me beforehand w/ questions.
Well, for example, I have experience *masking* arrays in IDL, but not in Numpy, and not using an object-oriented model. Nevertheless, I'd be happy to ask you q's... I'll finish the uncategorized docstrings I feel comfortable with (e.g., *not* distutils), and then help w/ any remaining MA's. Others, of course, do as thou willst, modulo Pierre's request. Thanks again! DG
_______________________________________________ Scipy-dev mailing list Scipy-dev@scipy.org http://mail.scipy.org/mailman/listinfo/scipy-dev
2009/8/5 Pierre GM <pgmdevlist@gmail.com>:
On Aug 5, 2009, at 1:33 PM, David Goldsmith wrote:
1) Is there anyone "in-the-know" who feels that reading "numpy-docs/ reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings?
Mmh. Can't really tell. Experience with masked arrays is certainly a prerequisite, but one shouldn't need to be an expert. Nevertheless, I'd be obliged if anybody willing to edit the MA docstrings could contact me beforehand w/ questions.
The best place to get an overview of masked arrays is Pierre's introduction here http://docs.scipy.org/doc/numpy/reference/maskedarray.html It's a little hard to locate in the doc-wiki, but can be found here http://docs.scipy.org/numpy/docs/numpy-docs/reference/maskedarray.rst Ralf (or others) feel free to work on the docstrings in Milestone "Operations On Masks" if you finish the other stuff and I still haven't gotten much further. You obviously have much more enthusiasm/time :) Something worth paying attention to, is making sure that the MaskedArray method docstrings and the equivalent functions in the ma module refer to each other and spell out any differences in behaviour. Compare http://docs.scipy.org/numpy/docs/numpy.ma.core.MaskedArray.set_fill_value/ http://docs.scipy.org/numpy/docs/numpy.ma.core.set_fill_value/ Cheers, Scott
On Thu, Aug 6, 2009 at 2:19 AM, Scott Sinclair <scott.sinclair.za@gmail.com>wrote:
2009/8/5 Pierre GM <pgmdevlist@gmail.com>:
On Aug 5, 2009, at 1:33 PM, David Goldsmith wrote:
1) Is there anyone "in-the-know" who feels that reading "numpy-docs/ reference/routines.ma.rst" (as it is now) is *insufficient* preparation for assisting w/ the Masked Array docstrings; or, put another way, feels that if one is not at least "well-practiced" using masked arrays, then one should not touch their docstrings?
Mmh. Can't really tell. Experience with masked arrays is certainly a prerequisite, but one shouldn't need to be an expert. Nevertheless, I'd be obliged if anybody willing to edit the MA docstrings could contact me beforehand w/ questions.
The best place to get an overview of masked arrays is Pierre's introduction here
http://docs.scipy.org/doc/numpy/reference/maskedarray.html
It's a little hard to locate in the doc-wiki, but can be found here
http://docs.scipy.org/numpy/docs/numpy-docs/reference/maskedarray.rst
Ralf (or others) feel free to work on the docstrings in Milestone "Operations On Masks" if you finish the other stuff and I still haven't gotten much further. You obviously have much more enthusiasm/time :)
more enthusiasm than time. luckily time is something you can make ...
Something worth paying attention to, is making sure that the MaskedArray method docstrings and the equivalent functions in the ma module refer to each other and spell out any differences in behaviour. Compare
http://docs.scipy.org/numpy/docs/numpy.ma.core.MaskedArray.set_fill_value/ http://docs.scipy.org/numpy/docs/numpy.ma.core.set_fill_value/
good catch. i'll fix that and check the other ones i did. cheers, ralf
Cheers, Scott _______________________________________________ Scipy-dev mailing list Scipy-dev@scipy.org http://mail.scipy.org/mailman/listinfo/scipy-dev
participants (4)
-
David Goldsmith -
Pierre GM -
Ralf Gommers -
Scott Sinclair