[Numpy-discussion] User Guide
rob.clewley at gmail.com
Thu Jul 18 18:21:24 EDT 2013
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
"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 :)
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?
> "The exception: one can have arrays of (Python, including NumPy) objects,
> thereby allowing for arrays of different sized elements."
> 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
Robert Clewley, Ph.D.
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
More information about the NumPy-Discussion