- 주석으로 설명하지 말아야 하는 것 : 코드에서 유추할 수 있는 내용, 설명 자체를 위한 설명을 달지 마라, 나쁜 함수/변수 이름에 주석을 달지 마라
⇒ 좋은 코드 > 나쁜 코드 + 좋은 주석
- 생각을 기록하라 :
⇒ TODO l 앞으로 해야할 일, FIXME | 오동작을 일으킨다고 알려진 코드, HACK | 아름답지 않은 해결책, XXX | 위험! 큰 문제가 발생할 수 있음
⇒ 상수값을 왜 그렇게 정했는지 이유를 설명하라
※ // 이런 제길, 이 리스트 안에 중복된 항목이 있으면 곤란해 지잖아!
// ⇒ XXX | 이 코드는 리스트 안에 있는 중복된 항목을 다루지 않는다. 그것까지 감안하면 예외처리가 너무 많을 것이기 때문이다