Incorrect documentation is often worse than no documentation.
Hofstadter's Law: It always takes longer than you expect, even when you take into account Hofstadter's law.
Incorrect documentation is often worse than no documentation.
Deleted code is debugged code.
The key to performance is elegance, not battalions of special cases.