← Back to context

Comment by nickm12

21 hours 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.