Don't document bad code - rewrite it.
Each new user of a new system uncovers a new class of bugs.
Controlling complexity is the essence of computer programming.
Trying to outsmart a compiler defeats much of the purpose of using one.
90% of the functionality delivered now is better than 100% delivered never.
If you're as clever as you can be when you write it, how will you ever debug it?