[SciPy-dev] Two Marathon questions

[Scott Sinclair]

> 2009/8/5 Pierre GM <pgmdevlist at 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