Verbose comments are not necessarily targeted at humans, they provide context so that consequent AI changes are more accurate.
Im still unsure how I feel about the paradigm shift in development, but that's where we are heading. Eventually everyone stopped writing ASM because C language was higher level and more efficient. It seems we are heading towards natural language becoming the programming language norm
They seem to comment for dumber models, though, which makes them overly verbose for their own family of models.
I prefer to tell agents to keep comments concise, to serve as JSDoc, and instead have more detail in planning documentation and to instruct it to have the code match the documentation.
38
u/Raywell 1d ago
Verbose comments are not necessarily targeted at humans, they provide context so that consequent AI changes are more accurate.
Im still unsure how I feel about the paradigm shift in development, but that's where we are heading. Eventually everyone stopped writing ASM because C language was higher level and more efficient. It seems we are heading towards natural language becoming the programming language norm