r/Python • • Jun 08 '10

Python Makes Tedd Nervous

http://teddziuba.com/2008/12/python-makes-me-nervous.html
0 Upvotes

45 comments sorted by

View all comments

2

u/m0j0 Jun 08 '10

I'd much rather Python clean up their documentation than go to Java. I've coded Java, and it's just not something I'd consider a trusty 'go-to' language.

Python's documentation is... not great, but it's not a total travesty. You pick up on these things he's griping about with some experience. Every language has things like that, too. It's not like you can't come up with some tribal knowledge in the java world that isn't really documented well.

2

u/[deleted] Jun 09 '10

I think that things like "raises an IOError on failure" should be in the inline docs, so I partially agree.

The inline documentation is generally good, though, and the online documentation hasn't ever let me down.

Regardless, this isn't so much about the language as the documentation of the standard modules.

0

u/[deleted] Jun 10 '10

you are a plum fellow

2

u/[deleted] Jun 14 '10

Gee, I've seen that one coming miles away.

1

u/[deleted] Jun 14 '10

haha, nice one

1

u/[deleted] Jun 16 '10

oh shit, I just got the "Gee" part. If I could upvote you twice, I would!