[SciPy-dev] can I help with the docs?

nicky van foreest vanforeest@gmail....
Tue Aug 11 16:06:52 CDT 2009


Hi Andrew,

I do not want to interfere with the scipy doc project... However,
after having read your ideas, might this cover your needs, at least in
part?

http://johnstachurski.net/lectures/index.html

bye

Nicky

2009/8/11 Andrew Hawryluk <HAWRYLA@novachem.com>:
> Good question. I'll let you know what I was thinking, and then you can
> tell me if I've misunderstood the documentation objectives.
>
> Each year I train a new set of engineering internship students in our
> department, and one of the things they learn is Python.  Upon arriving
> here they have taken a single course on C++ and another on
> Matlab/Mathematica/Excel etc., but no Python.  I usually start them off
> reading "Dive Into Python", but I'd also like a single place to send
> them to get a brief tour of proper NumPy use.  The main NumPy & SciPy
> docs are excellent (and improving rapidly), but they start a bit too
> abruptly for my needs. For example, the NumPy User Guide currently start
> with installation instructions, and then the next page of body text is a
> table of all the available array types.
>
> I would like something that briefly explains what NumPy and SciPy are,
> and why/when arrays are better than lists/dicts, perhaps followed by a
> brief tour of some common NumPy tricks, before diving into the more
> detailed sections.
>
> One possible table of contents would be
>
> Introduction
>  What is NumPy?
>  Building/Installing
>  Short Tour
>  How to find documentation
> NumPy Basics
>  ...
>
> What direction were you thinking the User Guide would take?
>
> Andrew
>
>
>> -----Original Message-----
>> From: scipy-dev-bounces@scipy.org [mailto:scipy-dev-bounces@scipy.org]
>> On Behalf Of David Goldsmith
>> Sent: 11 Aug 2009 1:16 PM
>> To: SciPy Developers List
>> Subject: Re: [SciPy-dev] can I help with the docs?
>>
>> Hi, Andrew, and thanks for your offer to help.  Can you be more
>> specific vis-a-vis what you have in mind?
>>
>> David Goldsmith, Technical Editor
>> Olympia, WA
>>
>> --- On Tue, 8/11/09, Andrew Hawryluk <HAWRYLA@novachem.com> wrote:
>>
>> > From: Andrew Hawryluk <HAWRYLA@novachem.com>
>> > Subject: [SciPy-dev] can I help with the docs?
>> > To: scipy-dev@scipy.org
>> > Date: Tuesday, August 11, 2009, 12:10 PM I'd like to help with the
>> > docs project. I have registered a user name of ahawryluk on the
> Wiki.
>> > Although the current focus is cleaning up the docstrings on the
> numpy
>> > module, I'm most interested in writing some introductory material
> for
>> > the NumPy User Guide.
>> >
>> > Andrew Hawryluk
>> > NOVA Chemicals Research & Technology Centre Calgary, Canada
>> >
>> >
>> >
>> > _______________________________________________
>> > Scipy-dev mailing list
>> > Scipy-dev@scipy.org
>> > http://mail.scipy.org/mailman/listinfo/scipy-dev
>> >
>>
>>
>>
>> _______________________________________________
>> Scipy-dev mailing list
>> Scipy-dev@scipy.org
>> http://mail.scipy.org/mailman/listinfo/scipy-dev
> _______________________________________________
> Scipy-dev mailing list
> Scipy-dev@scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev
>


More information about the Scipy-dev mailing list