Comments Considered Harmful

Описание и применение

<p>AI coding agents just love to comment don't they?</p> <p>Ask for a function, and you get a paragraph of commentary as a preface.</p> <p>Mostly harmless, or so I thought until I did a little digging.</p> <p>What happens when the code changes but the comment does not?</p> <blockquote> <p>The title is, obviously, a cheeky riff on Dijkstra's 1968 “Go To Statement Considered Harmful.” His concern was code that made programs harder to reason about; mine is context that can make intent harder to reason about.</p> </blockquote> <h2> Comments Are Input Tokens </h2> <p>Developers think of comments as

Задача

<p>AI coding agents just love to comment don't they?</p> <p>Ask for a function, and you get a paragraph of commentary as a preface.</p> <p>Mostly harmless, or so I thought until I did a little digging.</p> <p>What happens when the code changes but the comment does not?</p> <blockquote> <p>The title is, obviously, a cheeky riff on Dijkstra's 1968 “Go To Statement Considered Harmful.” His concern was code that made programs harder to reason about; mine is context that can make intent harder to reason about.</p> </blockquote> <h2> Comments Are Input Tokens </h2> <p>Developers think of comments as

Результат

<p>AI coding agents just love to comment don't they?</p> <p>Ask for a function, and you get a paragraph of commentary as a preface.</p> <p>Mostly harmless, or so I thought until I did a little digging.</p> <p>What happens when the code changes but the comment does not?</p> <blockquote> <p>The title is, obviously, a cheeky riff on Dijkstra's 1968 “Go To Statement Considered Harmful.” His concern was code that made programs harder to reason about; mine is context that can make intent harder to reason about.</p> </blockquote> <h2> Comments Are Input Tokens </h2> <p>Developers think of comments as

Доказательства

Comments Considered Harmful

Источник