정적 사이트 생성기 Hugo를 사용해 문서 사이트를 구축하도록 Google이 만든 오픈 소스 프로젝트 Docsy가 Linux Foundation으로 이전한다. 기술 문서가 개발자만을 위한 것이 아니라 인공지능 에이전트를 위한 직접적인 정보원이 된 시점에 이루어지는 이전이다.
Google의 개발자 관계 엔지니어이자 Docsy 운영위원회 위원인 Erin McKean은 수요일 프라하에서 열린 Linux Foundation 유럽 오픈 소스 정상회의 연설에서 이 조치를 발표했다. 이번 이전은 부분적으로 Linux Foundation과 연계된 프로젝트 생태계에서 Docsy가 널리 사용되고 있다는 점에 기반한다. 2024년 말 기준 약 2,200개의 프로젝트가 Docsy를 사용하고 있었으며, 여기에는 Kubernetes, OpenTelemetry, gRPC, Jaeger 등 Cloud Native Computing Foundation의 프로젝트가 포함된다.
자동화된 독자를 향하는 문서 프로젝트
Docsy는 2019년에 처음 발표되었으며, 오픈 소스 또는 독점 프로젝트와 함께 사용할 수 있는 기술 문서 전용 오픈 소스 템플릿이다. 그러나 최근의 변화는 인공지능 도구가 콘텐츠에 접근하는 방식과 이러한 도구가 프로젝트와 관련된 작업을 수행하기 위해 필요로 하는 지침의 형태에 초점을 맞추고 있다.
5월에 출시된 0.15.0 버전부터 Docsy는 일반적인 HTML 버전과 함께 모든 페이지의 Markdown 버전을 생성할 수 있으며, 사이트 콘텐츠의 색인을 제공하는 llms.txt 파일도 생성할 수 있다. 두 기능 모두 선택 사항이며 실험적이다.
7월에 출시된 0.16.0 버전에는 자동화된 어시스턴트가 따를 수 있도록 작성된 업그레이드 가이드가 추가되었으며, 조건과 단계, 검증 절차가 포함되었다. 8월에 출시된 0.17.0 버전은 llms.txt를 활성화한 사용자를 위해 각 페이지 상단에 숨겨진 지시문을 추가해, 방문한 에이전트를 사이트 색인으로 안내한다. 이 기능 역시 실험적이다.
실제로 무엇이 바뀌는가?
Docsy는 문서 개선 작업의 일부를 단순히 사람이 읽을 수 있도록 페이지를 구성하는 일에서, 모델과 에이전트가 콘텐츠를 찾고 이해하며 따를 수 있도록 콘텐츠를 정리하는 일로 전환한다. 기여자나 외부 사용자에게 의존하는 프로젝트의 경우, 이는 인공지능 도구가 공개 HTML 페이지에서 지침을 추론하도록 두는 대신 더 명확한 지침 버전으로 안내하는 것을 의미할 수 있다.
McKean은 더 나은 문서가 유지관리자에게 전달되는 일상적인 질문을 줄일 수 있다고 말한다. 사용자가 유지관리자의 개입 전에 답변을 확인할 수 있게 되기 때문이다. 이는 프로젝트에 잠재적인 운영상의 이점이지만, 그 자체로 에이전트가 콘텐츠를 올바르게 이해하거나 문서가 자동으로 정확해진다는 뜻은 아니다.
다음 단계: 에이전트의 가독성 측정
Docsy 팀은 AF documentation scores, 즉 문서가 에이전트에 얼마나 적합한지를 나타내는 점수라고 부르는 작업을 진행하고 있다. 목표는 인공지능 도구가 문서를 발견하고 탐색하며 소비할 수 있는 능력을 평가할 수 있는 지표를 유지관리자에게 제공하는 것이다. 단순히 추측하는 데 그치지 않도록 하기 위해서다.
이 지표의 형태나 최종 기준, 출시 시점은 아직 출처에서 명확히 밝히지 않았다. 또한 Markdown과 llms.txt 기능 및 이와 관련된 지시문은 선택 사항이고 실험적이므로, 실제 효과는 프로젝트의 도입 여부와 프로젝트가 작성하는 원본 콘텐츠의 품질에 달려 있다.
뉴스 출처
The New Stack - Software Development
원문 보기 ↗