소프트웨어 문서화(Documentation) 자료—소프트웨어가 어떻게 작동하고 어떻게 사용되는지를 설명하는 자료—는 지난 수십 년간 극적으로 발전해 왔습니다. 과거에는 주로 PDF나 정적인 텍스트 형태로 존재하던 문서들은 오늘날에는 훨씬 더 상호작용적이고 사용자 친화적인 형태를 갖추게 되었습니다.
하지만 이러한 문서를 제작하는 과정 자체는 여전히 시간 소모적이고 비효율적인 작업으로 남아있습니다. 개발자이자 기업가인 한왕(Han Wang)과 이한비(Hahnbee Lee) 역시 이 문제에 직면했던 경험이 있습니다.
왕 씨는 "2010년대에 Stripe, HashiCorp, Twilio를 비롯한 여러 기업들이 개발자 콘텐츠 분야의 기준을 높였습니다"라고 말했습니다. "그들은 훌륭한 개발자 경험(developer experience)을 갖춘 콘텐츠가 단순히 상품을 넘어선 경쟁 우위임을 입증했습니다. 그 이후 모든 기업이 이를 따라잡으려 노력했지만, 사실은 결코 쉬운 일이 아닙니다."
문서화 워크플로우를 단순화하여 게시하는 과정(주로 자신들의 효율성을 높이기 위함)에서 영감을 받아, 왕 씨와 이 씨는 코드를 기반으로 문서를 자동 생성할 수 있는 도구를 포함한 문서 작성 도구 모음인 Mintlify를 개발했습니다.
왕 씨는 "2020년대에는 문서화의 기준이 다시 한번 높아지고 있습니다"라며, "이번에는 단순히 사용자 인터페이스(UI)의 문제가 아니라, AI 덕분에 개발자와 편집자가 콘텐츠와 근본적으로 상호작용하는 방식에서도 변화가 일어나고 있습니다"라고 덧붙였습니다.
AI 기반의 비전
왕 씨와 이 씨는 대학 시절 만나게 되었습니다. 두 사람 모두 코넬 대학교 출신으로, 이 씨는 컴퓨터 과학 학부생이었고 왕 씨는 정보 과학 학사 학위를 전공했습니다.
학생 시절, 왕 씨는 가축 원격 모니터링 시스템인 FoodFul과 고객 커뮤니티 구축 플랫폼인 People 두 개의 회사를 설립했습니다. People이 사용자 참여 전문 기업인 Bettermode에 인수된 후, 왕 씨는 몇 달간 남아 일했지만 결국 Bain Capital Ventures의 파트너가 되기 위해 회사를 떠났습니다.
왕 씨가 Bain을 떠난 것은 2021년이었는데, 이 시기는 그와 이 씨가 Mintlify의 아이디어를 구체화하게 된 시기와 정확히 일치했습니다. 그들은 Mintlify를 비즈니스로 성장시키기 위해 Bain(왕 씨의 인맥을 활용하여)을 비롯해 Sourcegraph 공동 창업자인 퀸 슬랙(Quinn Slack) 등으로부터 시드 자금을 조달했습니다.
Mintlify는 전반적으로 개발자들이 가이드, API 참고 자료, SDK 문서, 그리고 소프트웨어 및 서비스의 세부 사항을 설명하는 챗봇(OpenAI API 기반)을 작성하는 데 도움을 줍니다. 이 플랫폼은 기본적인 문서 서식을 위한 내장 구성 요소와 템플릿을 제공하며, 문서가 코드베이스에 자연스럽게 삽입되도록 구조화합니다.
Mintlify는 문서를 작성하고 유지 관리하는 데 필요한 도구를 제공하며, 자동 업데이트 기능도 포함하고 있습니다.
문서 유지 관리를 지원하기 위해, 민트리파이는 또한 '오래된(stale)' 문서를 주기적으로 스캔하고 사용자가 어떤 콘텐츠와 상호작용하는지 감지하여 가독성을 높일 방안까지 제안합니다.
하지만 Mintlify의 자동화 기능에 대한 일부 비판도 존재합니다.
초기 사용자였던 DevClass의 팀 앤더슨(Tim Anderson)은 Mintlify가 "큰 가치가 없는" 코드베이스에 주석을 추가하는 경우가 있으며, 한 사례에서는 문서에 동일하게 사실과 다른 문장을 네 번이나 반복했다고 지적했습니다. 다른 사용자들 역시 Mintlify가 체계화되지 않았거나 최적화되지 않았거나, 기타 이유로 부실하게 작성된 코드에 혼란을 겪을 수 있다는 점을 언급했습니다.
왕 씨는 플랫폼의 한계점보다는 AI의 잠재력을 강조하며, 인간이 문서 작성 과정에서 완전히 배제되기는 어렵다는 점을 시사합니다.
왕 씨는 "저희가 본 바에 따르면, AI와 함께 콘텐츠의 역할이 변화하고 있습니다. 문서는 지원 메시지, 코드베이스, 제품 피드백으로부터 실시간으로 자동으로 진화할 것입니다"라고 말했습니다. 이어 "AI 지원은 제품 변경 사항과 사용자 피드백을 기반으로 기업이 콘텐츠를 생성할 수 있게 해줄 것입니다."
민트리파이드는 단순히 한두 개의 기능을 제공하는 것을 넘어, 서비스 전체에 걸쳐 혁신을 가져오고 있습니다.
왕 씨는 당시 기획 단계의 기술적 어려움에 대한 우려를 표명하기도 했습니다.
최근의 추세는 기존의 프로세스에 의존하는 것에서 벗어나, 지능형 시스템을 구축하는 쪽으로 기울고 있습니다.
궁극적으로는 사람의 노동력을 최소화하고, 기계의 능력을 극대화하는 것이 핵심이 될 것입니다.
이 모든 것이 모여 사람의 노동력까지 대체할 수 있는 미래를 만들 것입니다.
[출처:] https://techcrunch.com/2024/09/05/mintlify-is-building-a-next-gen-platform-for-writing-software-docs