TIL (Today I Learned)

2022.02.24

오늘 읽은 범위

4장. 주석

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

• 우리는 코드로 의도를 표현하지 못해, 그러니까 실패를 만회하기 위해 주석을 사용한다. (p.68)

• 부정확한 주석은 아예 없는 주석보다 훨씬 더 나쁘다. 부정확한 주석은 독자를 현혹하고 오도한다. (p.69)

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

• 책에서는 주석을 남기는 것에 상당히 부정적이라는 메시지를 전달한다. 어쩌면 나 역시 주석을 위한 주석을 남기는 행위를 한 것은 아닐까 생각한다. 지금까지 작성한 주석들이 또다른 누군가가 읽었을때 나의 의도를 정확하게 전달할 수 있을까라는 생각을 해본적이 없는 것 같다.
  책에서 주는 메시지와 같이 주석보다는 좀 더 쉬운 표현과 정확한 코드를 통해 나의 의도를 뚜렷하게 표현할 수 있도록 노력해야될 것 같다.

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