TIL (Today I Learned)

2022.02.25

오늘 읽은 범위

4장 주석 p.68-76

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

• 부정확한 주석은 아예 없는 주석보다 훨씬 더 나쁘다. 진실은 한 곳에만 존재한다. 바로 코드다. 표현력이 풍부하고 깔끔하며 주석이 거의 없는 코드가, 복잡하고 어수선하며 주석이 많이 달린 코드 보다 훨씬 좋다. (p.69)

• 많은 경우 주석으로 달려는 설명을 함수로 만들어 표현해도 충분하다.(p.70)

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

• 비영어권국가에서 일을 해서 그런지 지금 현장의 코드에는 주석이 많은 편이다 거의 설계서가 통채로 주석이 들어가 있다. 물론 설명을 함수로 표현해도 충분하지만, 지금 현장이 많은 사람들이 일을 하고 대부분 파견이다보니 잘 달린 주석에 편리함을 느꼈긴하다. 그래도 부정확한 코드를 설명하는 주석이 아닌 코드는 명확하게 써야한다는 것에 동의한다.

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