클린 코드 Clean Code - 애자일 소프트웨어 장인 정신 프로그램 프로그래밍 프로그래머
로버트 C. 마틴 지음, 이해영.박재호 옮김 / 인사이트 / 2013년 12월
평점 :
장바구니담기


S/W 대가가 주석 챕터에서 언급하지 않은 부분이 있다.

그것은 외국인 프로그래머의 경우는 어찌 할 것인가? 

나는 전산과 84학번으로 지금도 현업에서 프로그램을 개발한다.

내가 만나본 대부분의 개발자들은 영어를 잘 못한다. 영어문장으로 된 아래의 경우에서,

한국어로 주석을 달아 놓으면 직관적으로 이해가 쉽다.

책에 주석으로 한국인이 주석을 어찌 대해야 할지 추가해 놓지 않은 점이 아쉽다.

/**

 * @class Existence : 존재에 대하여

 *

 *        데카르트

 *        Cogito, ergo sum (라틴어)

 *        나는 생각한다. 그러므로 나는 존재한다.

 *        I think,therefore I am

 */

public class Existence {


    // 1. 보통의 미국인 프로그래머

    // I think, therefore I am --> 동어반복, 무의미한 주석

    void iThinkThereforeIam() {

    }


    /**

     * 2. 라틴어를 좋아하는 미국인 프로그래머

     */

    // I think, therefore I am --> 외국어 이름이어서 유의미한 주석, 그러나 라틴어 매소드 이름은 영어로 바꾸어야 하겠다.

    void cogitoErgoSum() {

    }


    /**

     * 3. 보통의 한국인 프로그래머

     */

    // 나는 생각한다. 그러므로 나는 존재한다. --> 외국어 매소드 이름이어서 유의미한 주석

    void iThinkThereforeIam() {

    }

}




댓글(0) 먼댓글(0) 좋아요(1)
좋아요
북마크하기찜하기 thankstoThanksTo