TIL (Today I Learned)

2022.02.24

오늘 읽은 범위

4장. 주석

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

• 잘 달린 주석은 그 어떤 정보보다 유용하다. 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다. 오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨려 해악을 미친다. (p.68)

• 때때로 주석은 구현을 이해하게 도와주는 선을 넘어 결정에 깔린 의도까지 설명한다. (p.71)

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

• 나는 평소에 필요한 경우 주석을 종종 사용하곤 하는데, 이 책에서는 주석을 매우 나쁜 것으로 취급해서 많은 생각이 들었다. 실제로 개발을 할 때 주석은 나에게 도움을 준 적이 꽤 많아서인지 책의 단호한 어투에는 공감하기 어려웠지만, 잘못된 주석의 예시에 대해서는 많이 배운 것 같다.

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

• 없음.