[Nomad Coders Challenge] Clean Code - Assignment #05

 

 

📍 It is part of a book club challenge on a programming learning website called Nomad Coders. The challenge is to demonstrate what I have learned after reading Clean Code by Robert C. Martin.

 

📝 It will consist of the following sections over three weeks: the range of reading, the top quotes from the book, my review, and remaining questions. 

  🔗Challenge Schedule

---

💻 I plan to read Clean Code in JavaScript and Python, referring to the GitHub repositories shared by Nomad Coders with the challengers.

 

Assignment #05

• 📚 Chapter 4. Comments
• ✔️ TIL 
  • Top quotes from the book
  • Assignment 
  • My review

---

 

📝 Top quotes from the book

•  
• 나쁜 코드에 주석을 달지 마라. 새로 짜라  -브라이언 W.  커니핸, P.J. 플라우거 
• 잘 달린 주석은 그 어떤 정보보다 유용하지만, 경솔하고 근거없는 주석은 코드를 이해하기 어렵게 만든다.
• 우리는 코드로 의도를 표현하지 못한 실패를 만회하기 위해 주석을 사용한다. 주석을 실패를 의미한다. 
  • 그러므로 주석이 필요한 상황에 처하면 곰곰이 생각하기 바란다. 상황을 역전해 코드로 의도를 표현할 방법은 없을까? 
  • 주석은 자주 거짓말을 한다. 오래될수록 코드에서 멀어진다. 주석은 변화하고 진화하여 괴물로 변한 코드를 따라가지 못한다. ... 더이상 지킬 필요가 없는 규칙이나 지켜서는 안 되는 규칙을 명시한다. ... 진실은 한곳에만 존재한다. 바로 코드다. 그러므로 우리는 주석을 간능한 줄이도록 꾸준히 노력해야 한다. 

 

🔍 Remaining questions

•  

 

✔️ Assignment 

• https://silver-ye.tistory.com/111
• https://kirahaa.github.io/clean-code-05/

• https://pleed0215.notion.site/TIL-2022-01-28-9e2213699e6d497cb902ee98b4ca5b47

 

🖊️ My review

I’ve learned a lot by exploring how others contribute to their blogs and GitHub repositories—they always inspire and teach me. I truly appreciate this assignment from the Nomad Coders Book Club.