[노개북] "클린코드" 챌린지 6일차

"노개북" 노마드 개발자 북클럽 6일차!!

#코딩 #개발자 #노마드북클럽 #노개북 #노마드챌린지 #클린코드 #3주스케쥴

 

목, 금 | Assignment #06

• 📚 4장. 주석
• ✔️ TIL

---

TIL (Today I Learned)

2022.02.25

 

오늘 읽은 범위

4장.주석

 

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

•  주석은 나쁜 코드를 보완하지 못한다. (p.69)
• 코드로 의도를 표현하라! (p.70)
• 정말로 좋은 주석은, 주석을 달지 않을 방법을 찾아낸 주석이라는 사실을! (p.70)

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

• 주석이라고 자유롭게 달아도 상관없는것인줄 알았다. 하지만 주석도 필요한주석, 도움이 되는 주석만 달아야 하는것을 알았고, 특히 예전 소스를 리팩터링하거나 수정을 할 경우, 혹시모를 상황을 대비하여, 원본소스는 주석으로 가려놨었는데, 그것도 나쁜습관이라는것을 알았다. 그리고 주석을 잘 달아놓은 코드가 좋은코드가 아니고, 그 코드 자체로 의미를 파악할수 있는 코드가 좋은코드라는것을 알았다.

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

• API DOCS 문서파일에 대해 가까워져보려고 노력해야겠다.