소프트웨어 개발자들이 작성하는 설치 안내 문서(README)는 종종 실제 사용자에게는 난해한 장벽이 됩니다. 개발자는 자신이 만든 소프트웨어에 대한 깊은 이해 때문에, 일반 사용자가 겪을 수 있는 기본적인 어려움이나 전제 조건을 간과하기 쉽습니다. 이러한 '개발자의 편향'은 문서의 불완전성으로 이어져 사용자 경험을 저해하는 주요 원인이 됩니다.
오픈소스 프로젝트 ActivityBot의 개발자는 이 문제를 해결하기 위해 흥미로운 실험을 진행했습니다. 실제 사용자에게 시간당 25유로를 지급하고, 그들이 README 문서를 따라 ActivityBot을 설치하는 과정을 영상 통화로 관찰한 것입니다. 참가자들은 화면을 공유하며 자신의 생각과 혼란스러운 부분을 소리 내어 말했고, 개발자는 이를 통해 잘못된 링크, 이해하기 어려운 용어, 비논리적인 문서 구성 등 다양한 문제점을 파악할 수 있었습니다. 각 세션이 끝날 때마다 개발자는 피드백을 반영해 README를 수정했고, 다음 참가자에게 개선된 문서를 다시 테스트하게 했습니다. 총 150유로의 비용으로 ActivityBot의 README는 훨씬 따라 하기 쉬워졌습니다.
이 사례는 문서 작성에 있어 '사용자 중심' 사고의 중요성을 극명하게 보여줍니다. 개발자는 자신이 이미 알고 있는 명령어 권한, 옵션 표기, 재부팅 필요성 같은 전제를 당연하게 여기지만, 초보 사용자에게는 이 모든 것이 낯설고 불분명할 수 있습니다. 인공지능(AI) 모델을 통한 모의 테스트도 가능하지만, 실제 사람의 목소리에서 나오는 답답함이나 예상치 못한 질문은 AI가 포착하기 어려운 미묘한 문제들을 드러냅니다. 비록 비용을 지불하기 어렵더라도, 몇몇 사람에게 자신의 문서를 따라 해보게 하고 그들의 솔직한 피드백을 듣는 것만으로도 문서의 품질을 크게 향상시킬 수 있습니다. 이는 소프트웨어의 접근성을 높이고, 궁극적으로 더 많은 사용자를 확보하는 데 기여할 것입니다.