2 ms·
In Go world, most libraries and frameworks come with documentation like that. I so miss being a Python dev
by avinassh 4y ago
In Go world, most libraries and frameworks come with documentation like that. I so miss being a Python dev
- throwaway894345 4y agoIn 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.
- carapace 4y agoYeah, 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.)
- thiht 4y agoI’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.