I'll start with one of my own.
Sometimes, inside a comment, I want to talk about a distant piece of code. While I might point to that location using some notation based on file names, function names and line numbers, all those descriptors are subject to change. What I do instead is to paste a short random string in both the comment and the target location. Something like this:
1 2 3 4 5 6 7 8 | void foo(){ // NOTE: #iexuje ... } void var(){ ... // TODO: Consider #iexuje } |
Most of the time my use of this trick is a symptom of something wrong with my code that should be solved instead of commented upon (a simple example would be duplicated code), but If I want to postpone fixing the underlying problem, this is the way I make sure it won't escape me. Naturally, I never modify a piece of code that contains one of those random identifiers without looking at the rest of its siblings.