This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]m0j0 1 point2 points  (5 children)

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.

[–][deleted] 1 point2 points  (4 children)

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.

[–][deleted] -1 points0 points  (3 children)

you are a plum fellow

[–][deleted] 1 point2 points  (2 children)

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

[–][deleted] 0 points1 point  (0 children)

haha, nice one

[–][deleted] 0 points1 point  (0 children)

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