Clean Code / 02 25 2022

주석을 사용하는것 자체는 사실 좋은 일이 아니다.

 

독자의 이해를 돕는 주석을 작성하는것은 사실 올바르고 이해가 쉬운 코드를 작성하지 못했기때문에 벌어지는

 

하나의 실수이며 좋은 코드는 최소의 주석이 달린 코드라고 할 수 있겠다.

 

또 코드는 유지보수되면서 변화하고 위치가 옮겨지는데,

 

그렇게되면 해당 코드 내용이 담긴 주석은 새로운 코드의 내용을 잘못 오도하는,

 

도움이 되지못하고 오히려 방해가 될 수 있는 여지가 있다.

 

 

따라서 주석 보다는 앞의 내용처럼

 

함수와 변수의 이름으로 코드의 내용을 알 수 있게한다든지, 

 

코드의 구조로 내용을 이해할 수 있게하는 방법이 더욱 좋다.

 

 

즉, 잘못된 주석은 코드의 내용을 더욱 어렵게하고 내용을 오도해 다른 코드까지도

 

들춰보게해야하는 악영향을 끼치는데,

 

이를 원천차단하기위해서는 그냥 코드를 잘 짜라는 내용이 이 단원의 핵심 흐름이다.

 

 

의아한점은..

 

책을 읽으면서 예시코드가 점점 자바 백엔드에 대한 지식을 요구하게되어

 

자바를 알긴해도 깊게 공부하지않은 나는 버겁긴 하다.

 

그래도 중심 내용을 파악하는데는 그렇게 어렵지않아서 꾸역꾸역 읽고있긴한데,

 

이렇게 읽는게 맞는지는 잘 모르겠다. 

 

물론 예시 어노테이션이나 메소드 내용을 계속 추측해보면서 읽을 수는 있겠는데 그러면 시간이 너무 오래걸림 ㅜㅜ