주석 나쁜 코드에 주석을 달지 마라. 새로 짜라. – 브라이언 W. 커니핸, P.J. 플라우거 주석은 사실상 ‘필요악’이다. 프로그래밍을 통해 좋은 코드를 만들면 주석은 전혀 필요없다. 코드로 의도를 표현하지 못해서 실패를 만회하기 위해 주석을 사용하는 것이다. 주석이란 1. 주석은 나쁜 코드를 보완하지 못한다 : 코드 품질이 나쁘기 때문에 주석을 달아 알아먹기 쉽게 만들기 위해 주석을 단다. 틀렸다. 코드를 정리해서 좋은 코드를 만드는게 정답이다. 자신이 저지른 난장판을 주석으로 설명하려 애쓰는 대신에 그 난장판을 깨끗이 치워라. 2. 코드로 의도를 표현하라 : 개발자는 코드를 “의도를 표현하기 위한 훌륭한 수단” 이라고 생각해야 한다. 코드만으로 의도를 설명하기 어려운 것은 잘못된 생각이다. Ex) ..