목록나쁜 주석 (1)

nyximos.log

[Clean Code] 4장, 주석

클린코드, 애자일 소프트웨어 장인정신 Robert C. Martin 들어가며 나쁜 코드에 주석을 달지 마라. 새로 짜라. - Brian Wilson Kernighan, Phillip James Plauger 주석이 필요한 상황에 처하면 곰곰이 생각하기 바란다. 상황을 역전해 코드로 의도를 표현할 방법은 없을까? 코드로 의도를 표현할 때마다 스스로를 칭찬해준다. 주석을 달 때마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 부정확한 주석은 아예 없는 주석보다 훨씬 더 나쁘다. 코드만이 자기가 원하는 일을 진실되게 말한다. 그러므로 우리는 (간혹 필요할지라도) 주석을 가능한 줄이도록 꾸준히 노력해야 한다. 주석은 나쁜 코드를 보완하지 못한다 표현력이 풍부하고 깔끔하며 주석이 거의 없는 코드가 복잡하고..
Books 2022. 2. 16. 15:37
이전 Prev 1 Next 다음