본문 바로가기

Books

주석 없이 코딩하기

일반 개발자들은 코드 자체를 통해 이야기해야 하는 상황에서 손쉽게 코드 대신 주석으로 이야기를 전해주려고 한다. 좋은 주석을 작성하려면 좋은 글을 쓸 줄 아는 사람이 돼야 한다. 주석은 컴파일러를 위한 코드가 아니라 다른 사람에게 의미를 전달하기 위한 단어들이다. 나는 동료 프로그래머들을 사랑하지만 그렇다고 해서 우리 같은 사람들이 다른 사람과 의사소통을할 때도 최고의 능력을 발휘한다고 말하기 어렵다. 우리가 코드가 안에 명확하고 이해하기 쉬운 주석을 달 것이라고 기대하는 사람들인가? 차라리 컴파일러를 위한 글쓰기에 집중하는 것은 어떨까? 정말 어쩔 수 없는 경우에 한해서만 주석을 다는 것이다.