코드에 주석을 추가하는 일반적인 이유는 코드 품질이 나쁘기 때문이다


모듈을 짜고 보니 짜임새가 엉망이고 알아먹기 어렵다


지저분한 모듈이라는 사실을 자각한다


그래서 자신에게 이렇게 말한다 "이런! 주석을 달아야겠다!"


아니다! 코드를 정리해야 한다!


표현력이 풍부하고 깔끔하며 주석이 거의 없는 코드가, 복잡하고 어수선하며 주석이 많이 달린 코드보다 훨씬 좋다


자신이 저지른 난장판을 주석으로 설명하려 애쓰는 대신에 그 난장판을 깨끗이 치우는 데 시간을 보내라!