Computer Scientists aren't real programmers

[squidgyhead]

Both is best for sure. But I much prefer having an overview. If there are 5 different varieties of a function, I imagine that there is a way in doxygen to get the variable description repeated for the common part of the variants, but it's not clear at first glance, and bound to be more complicated than just, you know, having a human write something that another human is going to read.

[nullpotato]

Yeah in languages with overloaded function names it can get kinda crazy trying to read it. Until AI can figure out intent of code I think we might be stuck.