Why the Rails founder automatically rejects 80% of Software Engineer applicants
medium.com
medium.com
// The following approach (some psuedocode follows) will not work because of xyz.
Though I'd still prefer not to have that. With a VCS + bugtracker that contains info on how the fixes were arrived at, or very verbose commit messages, you don't even need this.
Commit history is very useful for forensics, and I strongly encourage writing useful commit messages, but if you want to say very clearly "Do not try this!", that shouldn't be buried in history, but be clear in the code itself.
That's not to say the best way to do that is just commented-out code, of course.