[SciPy-dev] NumPy User Guide table of contents

[Andrew Hawryluk]

> -----Original Message-----
> From: scipy-dev-bounces at scipy.org [mailto:scipy-dev-bounces at scipy.org]
> On Behalf Of Pauli Virtanen
> Sent: 21 Aug 2009 1:30 PM
> To: scipy-dev at 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