[Numpy-discussion] numpy docs

[<jo...@st...>]

On Tuesday 16 May 2006 16:32, you wrote:
> That's great!
> I think it would be nice if it could somehow become a gateway for
> docstrings.  Are you only interested in examples?  I'm not sure what your
>  intentions are, but it would be nice if there were a Wiki page like yours
> where people could contribute docstring fixes and then those fixes would
> eventually find their way into the source with the help of someone with CVS
> write access.  Usage examples like the ones on your page are needed in the
> docstrings too.   My fear though is that with a wiki page, there's no real
> incentive to be concise.  People tend to just add more rather than erasing
> something someone else wrote.  I don't really want to read a flame war in my
> docstrings about whether the sum() method is superior to the sum() function,
>  etc.
>  
>  --bill


+1 on the docstrings. At the moment I will put my efforts in making the
example list more complete, though. It's actually a great way to learn
about the numpy features. I recommend numarray users to simply browse 
through the example list and pick up the new numpy features by reading 
some of the examples. But be aware that there are actually many more
as the list is not yet complete.

And don't hesitate to contribute! ;-)

Cheers,
Joris


Disclaimer: http://www.kuleuven.be/cwis/email_disclaimer.htm