[SciPy-dev] NumPy User Guide table of contents

Andrew Hawryluk HAWRYLA@novachem....
Fri Aug 21 15:37:14 CDT 2009


> -----Original Message-----
> From: scipy-dev-bounces@scipy.org [mailto:scipy-dev-bounces@scipy.org]
> On Behalf Of Pauli Virtanen
> Sent: 21 Aug 2009 1:30 PM
> To: scipy-dev@scipy.org
> Subject: [SciPy-dev] NumPy User Guide table of contents
> 
> Hi all,
> 
> It's great to see that people are interested in contributing narrative
> documentation to Numpy! I think this effort will be accelerated much
if
> we have a table of contents for the final manual we want, to guide the
> writing.
> 
> One suggestion is listed below. It's also on this wiki page:
> 
> 	http://scipy.org/Developer_Zone/UG_Toc


This is very helpful - thanks for putting it together. I only have a few
builds:

- section 3.5 "Modifying contents of arrays" may need a different name,
since the array methods (sum, min, max, ...) don't modify any array
contents and the ufuncs don't have to either. Maybe "Manipulating array
data" or "Calculations with array data" or "Number crunching". On second
thought, "Number crunching" is probably a poor choice for non-native
readers.

- should section 3.8 "Working with different types of data" be placed
earlier in the array basics? Could it be merged into 3.2 "Storing data
in arrays"?

Cheers,
Andrew


More information about the Scipy-dev mailing list