In the Python world, most docs give a couple of usage examples but no type information (at best it will usually tell you that an argument is “a file-like object” with no information about what “file-like” methods are required). Moreover, Sphinx just renders everything onto one giant page so you have no idea which class a given method belongs to without doing a bunch of error-prone scrolling (sqlalchemy was the worst because every class had the same method names).

I will take Go docs all day, every day over Python docs.

Yeah, Python docs are crap, PHP docs are the gold standard IMO (although Julia's docs are pretty frosty too. (I don't know anything about Go's docs.))

(I am not joking. I am not trolling. I love Python, but the documentation is mostly like notes taken by a distracted teenager.)

I’ll take the Go doc over Python documentation any day. Python docs are really worst in class, completely unreadable and useless when you want to do anything precise.