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
...OTOH, digging through Python source code is more pleasant than C++. So it balances out I guess.