문서화는 섹스와 같다.

Code Reading이라는 책을 보면 이런 문구가 나온다.

• 1분의 문서 읽기는 한 시간의 코드 읽기와 맞먹는다는 점을 명심할 것
• 문서화는 섹스와 같다. 좋을 때는 매우 좋고 나쁠 때에는 안 하느니만 못하다.

요즘 Taverna Plugin을 만들면서 뼈져리게 느끼는 말들이다. 무턱대고 만들어 보자고 소스코드부터 봤는데, 그게 아니었다. 미리 문서화된 문서들을 읽어봤으면 훨씬 더 수월했으련만...