반응형

알고리즘 3

[Clean Code] 당신이 주석을 작성하는 이유

주석의 3가지 얼굴 잘 달린 주석은 그 어떤 정보보다 유용하다. 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다. 오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨려 해악을 미친다. 우리가 주석을 쓰는 이유? 코드로 의도를 표현하지 못해, 그러니까 '실패' 를 만회하기 위해 주석을 사용한다. → 주석을 달 때마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 주석을 무시하는 이유 → 거짓말을 하니까! 항상도 고의도 아니지만 너무 자주 거짓말을 하니까, 코드가 오래될수록 주석은 멀어진다. 코드는 변화하고 진화한다. 일부가 여기 저기 옮겨지고 나뉘고 갈라지고 합쳐진다. 불행하게도 주석이 코드를 따라갈 수 없다. 주석은 나쁜 코드를 보완하지 못한다 모듈을 짜고보니 짜임새가 엉망이고 알아먹기 어렵..

ETC/Books 2021.11.21
반응형