I'd like to hear how other people approach this: A code comment worth keeping. Which decision would be hard to understand from the code alone? Developers, please describe the environment and the smallest example that shows the problem. What would you check first, and what result would change your next step? Keep passwords, tokens and other private values out of any code you share. A short example is welcome, even if your situation was a little different.