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