주석은 영어로 쓰는 연습을 :: 2005/07/05 11:40

/Pythoneer

귀도가 쓴 파이썬 스타일가이드를 읽다보니, 이런 얘기가 나온다.

Python coders from non-English speaking countries: please write your comments in English, unless you are 120% sure that the code will never be read by people who don't speak your language.


만에하나 한글주석을 쓰면, 그 코드는 다른 나라 프로그래머들에 의해 읽혀지지 않을꺼라고. 하긴 읽기 싫어질것 같기도 하다. 아예 주석이 없으면 모를까, 일본어/히브리어 등의 주석이 쓰여져 있으면, 코드 자체가 보기 싫겠지.

내 코드는 절대 다른나라 사람들이 볼리가 없어. 라고 생각하는 사람이야 어쩔 수 없지만, 그게 아니라면, 자신의 코드가 외국인에게도 부담없이 읽히기를 바란다면, 영어로 쓰는 연습을...

여담으로, 주석 뿐 아니라, CVS 커밋로그, 위키 change 로그 등도 해당된다. (그래서, 이곳 위키 change로그도... ^^;) 주석을 써야겠다고 생각한 부분을 영어로 표현하다보면, 해당 내용이 코드안에 스며들게 하는 효과까지 누릴 수 있다.
Trackback(2256) : Comment(0)
Trackback Address :: http://yong27.biohackers.net/trackback/159
Name
Password
Homepage
Secret
< PREV |  #1 ... #167 #168 #169 #170 #171 #172 #173 #174 #175 ... #307  | NEXT >