A Comments smell occurs when a method, class, or block is filled with explanatory comments — not because the logic is genuinely complex, but because the code structure itself is unclear. Comments in this context act like a deodorant: they mask fishy code rather than fixing it.
"The best comment is a good name for a method or class."
Comments are not inherently bad — but when they're needed to explain what the code does (rather than why a design decision was made), that's a signal to refactor.
"주석" 코드 냄새를 감지, 설명 및 수정합니다. 과도하거나 설명적인 주석이 기본 코드에 주석 대신 리팩터링이 필요하다는 신호를 보내는 경우입니다. 사용자가 주석이 많은 코드를 공유할 때, 주석 모범 사례에 대해 질문할 때, 가독성에 초점을 맞춘 코드 검토를 원할 때, "내 주석이 너무 과한가요?"라고 질문할 때, 코드 냄새에 대해 언급할 때, 코드 명확성을 향상시키고 싶을 때마다 이 기술을 사용하세요. 또한 사용자가 코드를 붙여넣고 "댓글 냄새"를 명시적으로 언급하지 않더라도 코드를 더 깔끔하게 만들고, 자체적으로 문서화하고, 이해하기 쉽게 만드는 방법을 묻는 경우에도 트리거됩니다. 출처: bsene/skills.