[Numpy-discussion] User Guide

[Rob Clewley]

Hi,

I see the desire for stylistic improvement by removing the awkward
parens but your correction has incorrect grammar. One cannot have
"arrays of Python," nor are Numpy objects a subset of "Python"
(because Python is not a set) -- both of which are what your sentence
technically states. I.e., the commas are in the wrong place. You could
say

"The exception: one can have arrays of python objects (including those
from numpy) thereby allowing for arrays of different sized elements."

but I think it is even clear to just unpack this a bit more with

"The exception: one can have arrays of python objects, including numpy
objects, which allows arrays to contain different sized elements."

In my experience, attempting to be extremely concise in technical
writing is a common cause of awkward grammar problems like this. I do
it all the time :)

-Rob

On Thu, Jul 18, 2013 at 9:18 AM, Colin J. Williams
<cjwilliams43 at gmail.com> wrote:
> Returning to numpy after a while away, I'm impressed with the style and
> content of the User Guide and the Reference.  This is to offer a Guide
> correction - I couldn't figure out how to offer the correction on-line.
>
> What is Numpy?
>
>
> Suggest:
>
> "The exception: one can have arrays of (Python, including NumPy) objects,
> thereby allowing for arrays of different sized elements."
>
> to:
>
> The exception: one can have arrays of Python, including NumPy objects,
> thereby allowing for arrays of different sized elements.
>
> Colin W.
>
> _______________________________________________
> NumPy-Discussion mailing list
> NumPy-Discussion at scipy.org
> http://mail.scipy.org/mailman/listinfo/numpy-discussion
>



-- 
Robert Clewley, Ph.D.
Assistant Professor
Neuroscience Institute and
Department of Mathematics and Statistics
Georgia State University
PO Box 5030
Atlanta, GA 30302, USA

tel: 404-413-6420 fax: 404-413-5446
http://neuroscience.gsu.edu/rclewley.html