Re: Documentation suggestions

Andrew,

The site changes for the new-to-Python person are a big improvement in
terms of the sequence of exposures, but from a marketing perspective,
the first thing they read about Python is still aimed at a programmer.
The bulleted points in BeginnersGuide/Overview are, again, things that
are important to programmers ("Automatic garbage collection frees you
from the hassles of memory management" means nothing to me, even now
after reading a Python book and several tutorials).

I wish there were some sort of sexy exposure to Python before hitting
them with the download. Again you purport to be making a page for
someone who's never programmed before, so almost certainly a Windows
user. And a Windows user is not going to download any program until
he's absolutely sure it won't destabilize his fragile system or infect
it. So nobody new to programming and new to Python is going to download
at the point you present them with that opportunity. Too bad there
isn't something like what Ruby does with the "Try Ruby In Your Browser"
thing, which is a very effective marketing tool (although obviously I
chose Python).

http://tryruby.hobix.com/

The other thing I vividly recall struggling with was: Do I download
this Python.org version for my Windows XP machine, because it's the
official one, or do I use the one from ActiveState because others say
it comes with all sorts of goodies for Windows users? I don't know what
the politics are there, but if I were you I'd take a stand and put it
on the download page to help the new person out, who is uncertain about
what to do.

Ultimately I downloaded ActiveState because I found their site easier
to understand (again speaking as a person relatively new to programming
and absolutely new to Python).

Thanks,

rpd

"I read part of it all the way through."--Samuel Goldwyn

www.dooling.com

.

Relevant Pages

  • Re: parralel downloads
    ...  As I have not much experience in programming, ...  easier ways to do this in python? ... new problem for me is that the url I want to download are in an xml ... and override the read method. ...
    (comp.lang.python)
  • Re: [Python-Dev] The baby and the bathwater (Re: Scoping, augmented assignment, fast locals &#
    ... but on a *space* of programs of identical function, as of manner of probing recent features and modules of Python that I manage to apply to it. ... parent lexical scope, be performed on the object bound to a parent scope ... I guess not in the manner of someone who started programming when programs had to fit in a couple dozen kbytes. ... intersection of the file tagged "arrogant would-be mind-readers", and of the file tagged "you are late on the normal trajectory if you did not reproduce my own oh-so-significant mistakes", both well-populated already, although I forgot who I put in them. ...
    (comp.lang.python)
  • Re: [Python-Dev] The baby and the bathwater (Re: Scoping, augmented assignment, fast locals &#
    ... Python 3.x development has started already, so it's not so much a "fairy ... of your approach when using the Python programming language. ... the mistake I mention, both in personal code, as well as code I was ... Nobody forces any school to present closures to beginners. ...
    (comp.lang.python)
  • Re: Attack a sacred Python Cow
    ... The fact that a function is defined within a class statement doesn't ... It's bad programming, but the world is full of bad programmers, and we ... It's also a way to make Python more complicated than it needs to be. ... def fun(self, cat): ...
    (comp.lang.python)
  • Re: Any maths or science fans using Solaris? (related to Mathematica on Solaris)
    ... Sage is based around the Python language, but glues together lots of open-source maths software - a list is at ... Automatically Tuned Linear Algebra Software ... Convex optimization, linear programming, least squares, etc. ... Cython: C-Extensions for Python ...
    (comp.unix.solaris)
Loading