개발자가 Documentation을 잘 하지 못하는 이유에 대해서 도구의 관점이 아닌, 개발자의 성향/특성 관점에서 접근해본 글이네요. 매우 흥미롭게 읽은 것 같습니다. 꽤 규모가 있는 곳에서 일하시는 분들은 한번 읽어보시면 공감 가는 부분이 많을 만한 포스트 입니다. 글을 잘 쓰기 위한 방법에 대한 해결책도 의미있게 제시되어 있네요. 한가지 추가로 덧붙여 보고 싶은 이야기는, 작은 팀에서는 분명 더 고려해보아야 할 요소가 있을 수 있다는 것입니다. 좋은 Documentation을 바탕으로 팀원간에 커뮤니케이션이 무리가 없도록 할 수 있다면 정말 좋겠지만, 그것은 Science 관점에서의 이야기 일 수 있고, Engineering 관점에서는 Documentation을 통해 얻을 수 있는 Communication의 효용과, Speed 간의 Trade-Off를 항상 고민하게 되는 것 같습니다. 잘 정돈되지 않은 Documentation은 항상 모든 개발자들에게 부채로 남겠지만, 그 부채를 통해 다른 효용 (빠른 개발 속도, 간결한 Communication) 을 얻을 수 있는 여지도 분명하기 때문에, 항상 우리 프로젝트에 가장 큰 효용을 가져다줄 수 있는 선을 고민해보면 좋을 것 같습니다.