Comment by nickm12
1 day ago
I believe both that code should be self-documenting but also that comments and documentation are a critical part of the code. Comments and documentation explain the functional contract of the code and why implementation choices were made.
Even if you have tests for an edge case, a comment inline with the code that explains why this edge case exists and why it is handled the way it is adds value to the code.
I agree. I’m talking more about these agents going in and breaking things. They might get some context when a test fails.