AI 때문에 기술 문서 작성자를 해고하거나 채용하지 않은 사람들에게

• AI가 인간 기술 문서 작성자를 대체할 수 있다는 믿음으로 채용을 중단하거나 해고한 결정이 심각한 실수임을 경고
• AI가 생성한 문서는 지능이나 공감 능력이 없으며, 제품의 진실과 맥락을 담지 못하는 빈 껍데기에 불과함
• 기술 문서 작성자는 사용자 공감, 정보 수집, 명확한 전달을 통해 제품을 이해 가능하게 만드는 핵심 인력임
• AI 보조 도구와 정책을 결합한 ‘증강된 기술 문서 작성’ 이 생산성을 높이는 현실적 대안으로 제시됨
• AI는 소음을 만들지만, 인간은 신호를 만든다는 결론으로, 기술 문서 작성자의 복귀와 재고용을 촉구

기술 문서 작성자를 대체한 AI 의존의 문제

• AI로 인해 기술 문서 작성자를 해고하거나 채용하지 않은 결정은 큰 실수로 지적됨
  • AI가 작성한 문서에만 의존하면 전문가의 감독과 맥락 이해가 결여된 결과물이 됨
  • 개발자에게 문서 작성 부담을 전가하는 것은 문서의 본질을 오해한 행위로 비판됨
• 기술 문서는 단순한 산출물이 아니라 제품의 진실(product truth) 을 담는 핵심 구성 요소임
  • 소프트웨어는 완성되지 않았고, 자명하지 않으며, 단순하지 않기 때문에 문서 없이는 사용 불가
  • 기술 문서 작성자는 정보 수집, 명확한 표현, 사용자 중심의 서술을 통해 제품을 연결함

AI 생성 문서의 한계

• AI가 생성한 문서는 지능이 없고 비전이 결여되어 있음
  • 수백만 토큰을 학습해도 문서 전략 수립, 구조화, 재사용 설계를 수행할 수 없음
  • 예외 상황, 미묘한 경계, 미완성의 긴장감을 포착하지 못해 내용이 공허함
• 법적 책임은 AI가 아닌 인간에게 남음
  • 잘못된 지침으로 피해가 발생하면 책임은 관리자나 기업에 귀속
  • AI 모델은 해고하거나 법정에 세울 수 없으며, 책임 회피가 불가능
• AI가 문서를 생성하려면 기존의 고품질 맥락(context) 이 필요함
  • RAG, Cursor 규칙, Claude Skills 등은 모두 기술 문서 작성의 연장선
  • 문서 작성자를 해고하면 AI가 학습할 기반 데이터 자체가 사라짐

기술 문서 작성자와 AI의 협업 가능성

• AI 도구와 교육을 제공하면 기술 문서 작성자의 생산성이 크게 향상됨
  • AI 정책을 통해 품질을 보호하면서 AI와 협업하는 미래형 문서 작성 환경 구축 가능
  • 이미 일부 기술 문서 작성자들이 AI를 활용해 작성·편집·출판을 자동화하는 사례 존재
• AWS CEO Matt Garman도 인간을 대체하기보다 보조하는 방향의 생산성 향상을 인정
  • 여러 기술 문서 작성자들이 AI를 활용한 문서 자동화 도구 개발에 참여 중
• 기업은 기술 문서 작성자와 함께 AI 전략을 수립하고 실험할 시간과 자원을 제공해야 함
  • 기술 문서 작성자는 제한된 자원으로 효율을 극대화하는 능력을 이미 보유
  • 적절한 도구와 기회를 주면 AI를 문서 품질 향상에 활용할 수 있음

재고용과 인식 전환의 요청

• AI가 인간의 역할을 완전히 대체했다는 잘못된 전제를 버려야 함
  • 기술 문서 작성은 단순한 단어 조합이 아니라 전문가 인터뷰, 제품 이해, 맥락 해석을 포함
• 기술 문서 작성자는 사치가 아닌 필수 인력으로, 제품을 사용 가능하게 만드는 번역자 역할 수행
  • 그들이 없으면 제품은 자기 자신을 설명하지 못하거나 거짓된 정보를 전달
• AI는 무한한 소음을 만들지만, 인간은 의미 있는 신호를 만든다는 결론으로 마무리
  • 해고된 기술 문서 작성자를 다시 불러들이고, 함께 일할 것을 촉구

감사 인사 (내용 요약)

• 초기 초안 검토와 격려를 제공한 Tiffany Hrabusa, Casey Smith, Anna Urbiztondo에게 감사
• 글 개선을 도운 Valentina와 기술 문서 작성 커뮤니티에 대한 감사 표시