Mostly it's not the clever code that is the problem, but the way people tend to use it. Instead of covering that clever piece code in a structure with an easy-to-understand interface and a lot of documentation explaining what things allow this to work properly, it's left without any clues what it is and how it works. Essentially a puzzle in the middle of code base to solve for everyone reading.
reply