이 게시물은 문서화가 실패하는 원인을 전제로 도메인과 챕터에서 겪은 시행착오와 해결 방식, AI가 문서화에 준 영향을 정리하는 니다. - 처음엔 커머스 위키 같은 자율 기여 구조를 시도했지만 후속 기여로 이어지게 만드는 것이 어려웠음을 언급 - 이미 문서가 잘된 조직(애즈)은 새로운 문서를 만들기보다 지식의 위치를 찾게 돕는 방향이 낫다고 설명 - 질문과 문서 공유를 막는 핵심 부담이 ‘내 지식이 틀릴까 봐’에서 비롯됨을 말하고, 질문 이벤트와 봇 지식 전달로 허들을 낮추는 접근 제시

AI가 문서화에 미친 변화

- AI로 초안을 빠르게 작성하고 챗봇으로 지식 전파를 자동화해 작성·공유 장벽을 낮춤 - AI를 활용해 질문·답변 현황과 문서 증가 같은 지표로 조직의 문서화 상태를 확인 가능함 - AI용 문서는 과도한 디테일이 포함될 수 있어 사람용 중앙 문서와 팀 레포 자동 축적 문서를 분리하는 구조를 선택

문서화를 시작하려는 조직이 먼저 할 일

- 문서화 수준을 진단하고 막히는 순간이 ‘사람에게 묻는지/문서를 찾는지/봇이 답하는지’로 유형을 구분해 부족한 부분을 채우는 것을 제안