That's not really the same, is it?

// 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.