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

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.