일반 개발자들은 코드 자체를 통해 이야기해야 하는 상황에서 손쉽게 코드 대신 주석으로 이야기를 전해주려고 한다. 좋은 주석을 작성하려면 좋은 글을 쓸 줄 아는 사람이 돼야 한다. 주석은 컴파일러를 위한 코드가 아니라 다른 사람에게 의미를 전달하기 위한 단어들이다. 나는 동료 프로그래머들을 사랑하지만 그렇다고 해서 우리 같은 사람들이 다른 사람과 의사소통을할 때도 최고의 능력을 발휘한다고 말하기 어렵다. 우리가 코드가 안에 명확하고 이해하기 쉬운 주석을 달 것이라고 기대하는 사람들인가? 차라리 컴파일러를 위한 글쓰기에 집중하는 것은 어떨까? 정말 어쩔 수 없는 경우에 한해서만 주석을 다는 것이다.
'Books' 카테고리의 다른 글
회의를 최소한 의미 있는 것으로 만들기 위한 원칙 (0) | 2014.06.02 |
---|---|
소스를 읽는 법을 배우게 (0) | 2014.04.28 |
톱날 갈기 (0) | 2014.04.15 |
[적을 만들지 않는 대화법] 56. 당신이 옳다는 마음을 넘어서라 (0) | 2014.03.28 |
[적을 만들지 않는 대화법] 55. 실패를 잊고 새롭게 시작하라 (0) | 2014.03.27 |