더북(TheBook)

3.9 코드 주석을 작성하지 마라

16세기에 살았던 시난이라는 튀르키예 건축가가 있다. 그는 이스탄불의 수많은 유명 건축물을 지었다. 그의 건축 솜씨에 대한 이야기에 따르면, 시난이 죽고 수백 년이 지난 후에 한 무리의 건축가들이 그의 건물 중 하나를 복원하기 시작했다. 그들이 교체해야 할 아치형 통로 중 하나에 쐐기돌이 있었는데, 조심스럽게 이 돌을 제거하자 돌 블록 사이에 끼워진 작은 유리병 안에 메모가 들어 있었다. 이 메모에는 “이 쐐기돌은 300년 밖에 가지 않을 것이다. 이 메모를 읽고 있다면 아마 이 돌이 부서졌거나 여러분이 이것을 수리하려고 했기 때문이다. 새로운 쐐기돌을 정확하게 다시 설치할 수 있는 유일한 방법은 다음과 같다.” 이 메모에는 쐐기돌을 제대로 교체하는 방법에 대한 기술적인 세부 사항이 적혀 있었다.

건축가 시난은 역사상 최초로 코드 주석을 제대로 사용한 인물로 볼 수 있다. 건물 곳곳에 글이 적혀 있는 반대 경우를 생각해 보자. 문에는 “이것은 문이다”라는 텍스트가 있고, 창문에는 “이것은 창문이다”라고 쓰여 있을 것이다. 모든 벽돌 사이에는 “이것은 벽돌이다”라는 메모가 담긴 유리병이 있을 것이다.

신간 소식 구독하기
뉴스레터에 가입하시고 이메일로 신간 소식을 받아 보세요.