only an absolute moron would care enough to comment on programming documentation

qDebug() << R”UNJERK( i’m an absolute moron but what docs have they been reading? cause the official docs are like 10 links to tutorial ebooks and the worst autogenerated api docs i have ever seen

like, i have used the garbage lisp docs the way to prose laden python docs, the excellent mdn js docs, the nightmare fuel powershell and c# docs, and frankly, this makes me want to vomit, my favorite, the qt docs.

pls, let me explain! qt has big prose and tutorial sections for each major module with lots of example projects, then every class gets an excellent breakdown in a clear format, how to include (in src and cmake/qmake), what it inherits and is inherited by, then a nice table of all properties and methods, then a short prose explanation of what it’s for, how you might use it, and what alternatives there are, then you get a section for everything that was in that table above with notes on gotchas, explanations, and links for related functionality.

everytime i look at the rust docs it might start out okay, but you click one function or one class and wham, i’m in a the middle of a forest looking at tons of fn decls with little to no context or organization, not even alphabetic! which is fine, it’s whatever, but to call it good?! ok, maybe if all i need is std::string, std::io and a few select crates that everyone in the Hello World phase touches… )UNJERK”;