본문 바로가기

클린코드/클린코드 애장일 소프트웨어 장인 정신

클린코드 4장 주석

우리는 코드로 의도를 표현하지 못해, 그러니깐 실패를 만회하기 위해 주석을 사용한다. 주석을 달 때마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 프로그래머들이 주석을 엄격하게 관리해야 한다고 그래서 복구성과 관련성과 정확성이 언제나 높아야 한다. 애초에 주석이 필요 없는 방향으로 에너지를 쏟는편이 낫다.

진실은 한곳에만 존재한다. 바로 코드다. 코드만이 자기가 히는일을 진실되게 말한다.

주석을 넣을때는 반드시 필요한경우 코드로만으로 설명이 되지 않는 부분만 넣도록 한다.