no swim no life
CODE complete, 32: 문서화에 들일 노력을 코드에 쏟아 부어라. 본문
저는 주석이 책의 표제나 목차와 같기를 바랍니다. 주석은 올바른 섹션을 찾는 데 도움을 주며, 그 다음부터 코드를 읽기 시작합니다. 프로그래밍 언어로 작성된 20줄의 코드를 읽는 것보다는 영어로 작성된 한 문장을 읽는 것이 훨씬 빠릅니다.
....
마치 당신들은 한 번도 다른 사람이 작성한 코드를 수정해야 했던 적이 없었던 것처럼 들리는군요. 저는 제가 바꿔야 하는 두 줄짜리 코드를 찾기 위해서 엄청나게 집중해서 수 백 줄의 코드를 읽을 필요는 없다고 생각합니다.
'work > fundamental' 카테고리의 다른 글
CODE complete, 33: 개인 성격 (0) | 2008.12.20 |
---|---|
CODE Complete, 31: 배치와 방식 (0) | 2008.11.21 |
(작성) 변수 (1) | 2008.09.25 |
Comments