동작 반복은 줄인다
`let lucky_number = 7`처럼 코드가 이미 말하는 내용은 주석으로 다시 쓰지 않습니다.
좋은 주석은 코드가 말하지 못한 판단을 남긴다
주석을 추가하기 전에 반복 설명인지, 숨은 제약을 드러내는지, 구현 변경과 함께 유지될 수 있는지 확인합니다.
의도와 제약을 남긴다
대안 선택 이유, 경계값, 안전성 전제처럼 다음 사람이 놓치기 쉬운 판단을 씁니다.
코드와 함께 고친다
구현이 바뀌었는데 예전 설명이 남으면 주석이 오히려 위험 신호가 됩니다.