The Dongola Times

(Anachronistic) Dispatches from the Kingdom of Makuria.
10th of July, 2012


Some people do not document their code, which is bad. Some have such large functions that one function does too many unrelated, non-trivial things and it would be better if all these were broken out into functions of their own. These things are bad.

However, the opposite of these things is bad, too. Having a function that is merely a glorified, over-documented version of the operator it is using will waste your time and it is silly, a sign of inexperienced over-eagerness.


I must be aging, but still: this kind of thing is really absolutely irritating, especially since all this stuff channels back to one single call in the entire source code. I do not support this kind of thing, to put it gently.