Note that I do not discourage comments. Comments in code can be very useful. But they do not help you find the code responsible for a certain business requirem

Note that I do not discourage comments. Comments in code can be very useful. But they do not help you find the code responsible for a certain business requirement. Not unless that's what you put in the comment e.g. a BR reference. I find code comments to be at their best, when they explain how the code works or is to be used or how it relates to something elsewhere. You know, comments about the code or other code. Relevant to understanding what you're about to read. Comments that are essentially user stories disrupt the flow and don't help interpret the actual logic. Those comments belong elsewhere.