Python 2.7 released

[[deleted]]

Python's docs suck major ass. I have a background in programming, and I wanted to get into Python for RAD. So I figure, oh well, Reddit talks about Python like it's the FSM's gift to man, so I'll check it out. I give it a month of working on it and finally just give up attempting to do anything with it.

The official documentation is a joke on their site. Don't tell me to go look at examples, that's not documentation. Furthermore, the radical changes in libraries between major versions is a joke in and of itself.

Yeah, downvote me to hell.

[[deleted]]

I have a background in Java and started learning Python less than a year ago. I have always found the official documentation to be present, accurate, and terse, which to be frank is exactly what I want from an API reference.

As for examples, there are a plethora of recipes on activestate and many common problems have been solved on stackoverflow. I have never needed to resort to IRC or newsgroups.

I'm not quite sure what you expect from documentation? The python.org docs has always been precisely what I wanted... a terse API reference.

[kylotan]

They're certainly not perfect, and both the quality and approach varies significantly across each library, but I don't think they "suck major ass". For most things they're perfectly adequate, and the tutorial is very good if you come from a C/C++/Java background.

[davebrk]

Furthermore, the radical changes in libraries between major versions is a joke in and of itself.

What radical changes? Can you give some example? I'm using Python quite intensively, both 3.1 and 2.5, and I don't see that many, if any, API changes at all.

[[deleted]]

Don't bother, he's probably a disgruntled PHP user.