README를 실제 사용자에게 검증받다
Key Point
README 개선의 핵심은 LLM 시뮬레이션이 아닌 실제 사용자의 음성 피드백이며, 사소한 비용으로 문서 품질을 근본적으로 향상시킬 수 있다.
핵심 요약
- 개발자들은 문서 작성을 제대로 하지 않는데, 저자는 ActivityBot README 작성 시 실제 사용자 피드백을 받기로 결심했다.
- NLnet 그랜트 지원 과정에서 €25의 보수를 지급하기로 약속한 후 마스토돈에서 모집한 사람들과 화상 통화를 진행했다.
- 테스트 방식은 단순했는데, 자원자가 화면을 공유하며 실시간으로 README를 따라하면서 무엇을 이해하지 못했는지, 뭐가 혼란스러웠는지 말하도록 했다.