오늘 TIL 3줄 요약
- 함수나 변수로 표현할 수 있다면 주석을 달지 마라
- 나쁜 주석
- ToDo 주석
</예시>
TIL (Today I Learned) 날짜
2022. 04.28
오늘 읽은 범위
4장 주석
책에서 기억하고 싶은 내용을 써보세요.
- 나쁜 주석 : 대다수 주석이 이 범주에 속한다. 일반저긍로 대다수 주석은 허술한 코드를 지탱하거나, 엉성한 코드를 변명하거나, 미숙한 결정을 합리화하는 등 프로그래머가 주절거리는 독백에서 크게 벗어나지 못한다.
- 있으나 마나 한 주석 : 때때로 있으나 마나 한 주석을 접한다. 쉽게 말해, 너무 당연한 사실을 언급하며 새로운 정보를 제공하지 못하는 주석이다.
- 의무적으로 다는 주석 : 모든 함수에 javadocs를 달거나 모든 변수에 주석을 달아야 한다는 규칙은 어리석기 그지없다. 이런 주석은 코들르 복잡하게 만들며, 거짓마을 퍼뜨리고 혼동과 무질서를 초래한다.
- 함수나 변수로 표현할 수 있다면 주석을 달지마라.
오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요
- 어지간하면 주석을 달지 말자. 단 어떠한 방법으로도 코드로 표현이 되지 않는 경우에만 조금씩 사용하자.
궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.
- 특별히 없다.
오늘 읽은 다른사람의 TIL
'IT > Clean Code 도전' 카테고리의 다른 글
6장 객체와 자료구조 (0) | 2022.05.03 |
---|---|
5장 형식 맞추기 (0) | 2022.05.02 |
3장 함수 (0) | 2022.04.27 |
Mission: 나의 최애 북틸 (0) | 2022.04.25 |
2장 의미있는 이름 (0) | 2022.04.24 |