"내 설명서 따라 해봐" 돈 주고 일반인 섭외했다가 멘탈 털린 개발자

요약 많은 개발자들이 문서 작성에 서툴며, 흔히 "매뉴얼이나 읽어라(RTFM)"고 말하지만 정작 제대로 된 설명서조차 없는 경우가 많습니다. 오픈소스 프로젝트를 진행하던 한 개발자는 자신이 작성한 설치 안내문(README)에 얼마나 많은 맹점과 편향이 숨어있는지 깨닫고 독특한 실험을 진행했습니다. 개발자는 마스토돈(Mastodon)을 통해 1시간 동안 자신의 README를 보고 직접 프로그램을 설치해 볼 참가자들을 모집했고, 시간당 25유로(약 3만 7천 원)를 지급했습니다. 실험 방식은 화상 통화로 화면을 공유한 채 참가자가 설치 과정을 진행하며 이해가 안 가거나 헷갈리는 점, 짜증 나는 순간을 실시간으로 소리 내어 말하도록 하는 것이었습니다. 실험 결과는 충격적이었습니다. 데모 링크 오류부터 터미널에서 README를 열람하는 습관, '숨김 파일 이름 바꾸기'의 모호함, 기술 용어 설명 부족, 심지어 본인이 재미있다고 넣은 농담이 오히려 유저를 크게 혼란스럽게 만든다는 사실까지 줄줄이 지켜봐야 했습니다. 게다가 정작 이 소프트웨어가 무엇을 하는 프로그램인지조차 제대로 설명되어 있지 않았습니다. 개발자는 매 테스트가 끝날 때마다 지적받은 문제점을 고쳐 다음 참가자에게 테스트하기를 반복했고, 총 150유로(약 22만 원)를 들여 '면전에서 신랄한 비판을 듣는 세션'을 마쳤습니다. 그는 "상담 치료를 받는 것보다 훨씬 저렴했다"며, LLM(인공지능) 대신 실제 사람의 목소리와 고통 어린 표정을 직접 들어야만 비로소 제대로 된 문서를 완성할 수 있다고 강조했습니다.