8.1 오래된 주석 제거
- 오래된 주석은 시간이 지나면 코드와 동기화되지 않아서 잘못되거나 오해의 소지가 있는 주석도 포함되기 마련이다.
- 버전 관리가 잘 안된다!
8.2 주석 처리된 코드 제거
- 버전 관리 시스템이 있는데 굳이 남겨놓을 필요가?
8.3 불필요한 주석 제거
- 코드가 주석만큼 읽기 쉬울 때 불필요하다. 지우자
8.4 메서드의 이름으로 주석 대신하기
- 메서드의 이름이 무슨 역할을 하는지 확실하게 지어서 주석을 작성할 일이 없도록 하자
8.5 불변속성을 문서화한 주석 유지
- 이 주석으로 누군가 버그를 만드는 것을 막을 수 있는가?
- 로컬이 아닌 불변속성을 문서화하는 주석은 코드 또는 자동 테스트로 변환해야 한다.
여의치 않을 때는 주석으로 유지하자