[노개북] 클린코드 8일차 - 노마드 코더

노마드코더

 

 

 

😀 책에서 기억하고 싶은 내용을 써보세요.

• 주석은 나쁜 코드를 보완하지 못한다
  => 나쁜 코드에 주석을 달지 마라. 새로 짜라 - 브라이언 W. 커니핸, P.J. 플라우거 -
  => 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다.
  => 오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨려 해악을 미친다.
• 주석은 오래될수록 완전히 그릇될 가능성도 커진다.
  => 프로그래머들이 주석을 유지하고 보수하기란 현실적으로 불가능하다.
• 주석을 달기로 결정했다면 충분한 시간을 들여 최고의 주석을 달도록 노력한다.

 

🤔 오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요.

1. TODO 주석은 니꼬쌤의 강의에서 작성한걸 한번 보고 자주 사용하고있습니다.
   => 자주는 아니더라도 조금씩 사용하고 있던걸 봐서 내심 기분이 좋았습니다.
   => 인텔리제이에서도 TODO 주석을 검색 할 수 있다는 걸 처음 알았습니다. -> 참고 링크
2. 주석을 달면서 확실히 예전에 달았던 주석을 잘 안보게 된다는 것을 인지하게 되었습니다.

 

🔎 궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요. 

• 어떻게 주석을 최소화 할까?
  => 저자는 코드에 정보를 담으라고 권한다.
  => 중복되는 정보를 주는 주석은 제거
• 현재 진행했던 프로젝트는 공부를 위해 대부분의 코드에 주석이 달려있는 상태
  => 주석을 하나씩 지워 나가면서 코드명에 정보를 담는 연습 진행 예정
  => 중복되는 주석은 지워 나가기

 

👀 소감 3줄 요약

• 주석은 최소하 하자!
• 주석은 오래 될수록 거짓된 정보로 남게 된다.
• 리팩터링을 할 때 주석을 수정하는건 거의 불가능에 가깝다.