17장 냄새와 휴리스틱
Clean Code 완성본
1. 📌 핵심 개념 정리
✅ 요약하기
1. 주석 (Comments)
부적절한 정보: 소스 코드 관리 시스템, 버그 추적 시스템 등 다른 곳에 저장해야 할 정보(작성자, 수정일, SPR 번호 등 메타 정보 제외)는 주석으로 적합하지 않습니다. 주석은 코드와 설계에 대한 기술적 설명을 보충하는 역할입니다. 변경 이력이나 장황한 날짜 기록은 피해야 합니다.
쓸모 없는 주석: 오래되거나, 내용과 맞지 않거나, 잘못된 정보는 더 이상 쓸모가 없습니다. 주석은 시간이 지...