어느 작은 서점이 있었다. 책장마다 먼지가 쌓이고, 손님은 드물었지만, 주인장은 매일 아침 책상 앞에 앉아 무언가를 썼다. 손님들은 가끔 물었다. “왜 이렇게 외진 곳에 서점을 차리셨어요?” 그러면 주인장은 웃으며 대답했다. “책은 읽는 것만큼 쓰는 것도 중요하니까요. 누군가는 읽어야 할 글을 누군가는 써야 하지 않겠어요?” 그 서점은 결국 문을 닫았지만, 주인장이 남긴 글은 몇몇 독자의 책장에 오래도록 남아 있었다.
소프트웨어 개발의 세계에서도 비슷한 일이 벌어지고 있다. 코드를 짜는 것만큼 중요한 것이 그 과정을 설명하는 글쓰기다. 하지만 이 글쓰기에는 보이지 않는 책임이 따른다. 단순히 정보를 전달하는 것을 넘어, 독자가 그 정보를 어떻게 받아들이고 활용할지에 대한 고민이 필요하다. 기술 블로그나 문서는 종종 ‘지식의 기부’로 여겨지지만, 그 이면에는 사회적 계약이 존재한다. 글을 쓰는 사람은 독자에게 정확한 정보, 맥락, 그리고 때로는 경고까지 제공해야 할 의무가 있다.
문제는 이 계약이 자주 무시된다는 점이다. 일부 기술 글은 마치 사용 설명서처럼 건조하게 작성된다. “이렇게 하면 됩니다”라는 문장 뒤에 숨겨진 가정이나 위험 요소는 언급되지 않는다. 예를 들어, 특정 라이브러리를 사용하라는 글은 그 라이브러리의 한계나 대체재에 대해서는 침묵한다. 독자는 그 글을 믿고 코드를 작성하지만, 나중에 예상치 못한 문제를 마주하게 된다. 이럴 때 글쓴이의 책임은 어디까지일까?
기술 글쓰기의 또 다른 딜레마는 ‘완벽한 정보’의 환상이다. 모든 기술에는 장단점이 있고, 모든 해결책에는 트레이드오프가 따른다. 하지만 많은 글은 마치 유일한 정답인 것처럼 단정적으로 서술된다. 이는 독자들에게 잘못된 기대를 심어줄 뿐만 아니라, 기술 커뮤니티 전체의 건강에도 해롭다. 글쓴이는 자신의 경험이 부분적이라는 사실을 인정하고, 독자가 스스로 판단할 수 있도록 충분한 맥락을 제공해야 한다.
글쓰기는 지식의 전달이 아니라, 지식의 재구성이다. 그 재구성 과정에서 글쓴이는 자신의 편견, 경험, 그리고 한계를 드러내야 한다.
이와 같은 책임은 비단 기술 글에만 국한되지 않는다. 모든 종류의 글쓰기는 독자와의 암묵적 약속 위에 서 있다. 그 약속은 “내가 제공하는 정보는 믿을 수 있으며, 당신이 그 정보를 바탕으로 내린 결정에 대해 나는 일정 부분 책임을 진다”는 것이다. 이 책임은 법적인 것이 아니라, 도덕적인 것이다. 하지만 도덕적 책임이 무시될 때, 그 피해는 결국 독자들에게 돌아온다.
기술 글쓰기의 사회적 계약은 단순히 ‘좋은 글’을 쓰는 것을 넘어선다. 그것은 독자에 대한 존중이며, 기술 커뮤니티에 대한 기여다. 글쓴이는 자신의 글이 어떻게 사용될지, 어떤 영향을 미칠지 고민해야 한다. 때로는 그 글이 누군가에게 영감을 주기도 하고, 때로는 누군가의 실수를 막기도 한다. 그 무게를 인식하는 것이야말로 진정한 기술 글쓰기의 시작이다.
이 글이 처음 소개된 곳은 개발자 커뮤니티에서 활발히 논의되는 공간이었다. 원문은 여기에서 읽을 수 있다.
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
