책5 4. 주석 주석 잘 달린 주석은 그 어떤 정보보다 유용하다. 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다 오래되고 조잡한 주석은 거짓과 잘못된 정보를 퍼뜨려 해악을미친다. 우리는 코드로 의도를 표현하지 못해， 그러니까 실패를 만회하기 위해 주석을 사용한다. - 요약 - 주석을 사용하기보다는 코드를 사용해서 의도를 나타내는 것을 지향하자. 특히 주석은 유지보수가 쉽지 않기 때문에 메서드에 대한 설명을 단순 나열하는 주석은 피해야 한다. 되도록이면 코드로 표현할 수 없는 정보를 전달해야 할 때만 주석을 사용하자 1. 주석을 사용할만한 경우 1.1 직관적이지 않은 정보를 전달할 때 코드를 작성할 때 표현식이라던지, 외부 라이브러리에 의해 코드를 직관적으로 해석하기 어려울 때가 있다. 이럴 때, 주석을 통해 .. 2023. 6. 18. 이전 1 2 다음