🧹  CleanCode

: 코드는 요구사항을 표현하는 언어 (잘짜여진 요구사항은 테스트 케이스로 써도 좋다)스스로 요구사항을 결정하는 기계가 나타나지 않는다면, 코드는 존재하리라: 고행(wading) = 나쁜코드를 헤쳐나감: 르블랑의 법칙(leblanc's Law) = 나중은 결코오지 않는다

변수나 클래스에 따로 주석 설명이 필요하다면, 의도를 분명히 드러내지 못했다는 것이다.코드의 함축성 이 문제 → 독자가 다 알고 있을것이라 생각하지 말고, 정보를 제공해야한다.나름대로 널리쓰이는 의미 일지라도, 다른의미와 혼동될 수 있다.hp : (1) 유닉스 플렛폼

if / else / while 문에 블록은 한줄이어야 한다. → 감싸는 함수(enclosing function)가 작아진다. 거기서 함수를 호출하도록 한다. → 블록안의 함수 이름을 적절하게 짓는다면, 코드를 이해하기 쉬워진다.함수내 들여쓰기는 1~2단 내로 제한한다

나쁜 코드에 주석을 달지 말라. 새로 짜라. - 브라이언 W. 커니핸, P.J. 플라우거잘 달린 주석은 그 어떤 정보보다 유용하다.경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다.오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨린다.사실 주석은 필요악 이다.