News for hackers. Stuff that matters.
Re:Magnum: Lightweight, modular C++11 graphics middleware fo... by bogwog on Monday April 25, 2022 @10:08PM (#31163227)
I’ve had the complete opposite experience. I’ve yet to use a non-trivial Python library/framework where I didn’t end up having to dig through the source code to figure out how to do something. The dynamic nature of the language makes it hard to auto generate useful docs. With something like Doxygen you can easily know exactly what types a function expects, how to construct those types, etc.

...OTOH, digging through Python source code is more pleasant than C++. So it balances out I guess.

Re:Magnum: Lightweight, modular C++11 graphics middleware fo... by mosra on Tuesday April 26, 2022 @06:25AM (#31165720)
While I'm here, a shameless self-promo -- Magnum uses a Python doc generator that includes type annotations by default, moving it closer to what you're used to from C++: https://blog.magnum.graphics/announcements/introducing-pytho...

(Sure, it still means the library has to make those annotations in the first place, and have them correct, but the newer and more complex libraries fortunately do, if even just to make IDE autocompletion work.)

Re:Magnum: Lightweight, modular C++11 graphics middleware fo... by mshockwave on Tuesday April 26, 2022 @02:06AM (#31164482)
same, C++ doc can be awful...if it's hand-written, but doxygen is quite good. On the other hand, docs for dynamic languages like javascript and python often hang me there with ambiguous descriptions like "string-like" or "buffer-like" -- yes, I know what those descriptions _mean_ but that doesn't really give me enough confidence to use those APIs.
Re:Magnum: Lightweight, modular C++11 graphics middleware fo... by trinovantes on Monday April 25, 2022 @10:51PM (#31163469)
Which python libs do you find insufficiently documented? Admittedly I've only used Python for quick scripts or apps (bs4, fitz, flask) rather than my primary language so maybe my view is somewhat biased