네이버 사내 기술 교류 행사인 NAVER ENGINEERING DAY 2025(5월)에서 발표되었던 세션을 공개합니다. [발표 내용] Docusaurus와 Typesense를 통해 기존 Redoc 기반 커머스API 문서 사이트를 변경하면서 정리한 Docusaurus 채택 배경과 특징, Typesense 특징 및 인프라 구성, 그리고 배포프로세스 등을 설명합니다. 마지막으로 이러한 변경을 통해 정성적 정량적인 유의미한 결과를 소개하며 개발하면서 겪은 긍정적인 경험 및 남은 과제 등을 공유합니다. [목차] 1. 커머스API와 커머스API문서 소개 2. 기존 문서 플랫폼의 한계점 1. Redoc 기반 플랫폼의 특징과 이해 2. UX 및 사용성 이슈, 커스터마이징의 어려움 3. Docusaurus 채택 배경 1. 오픈소스 선정 배경 및 해외 사례 조사 2. Docusaurus와 docusaurus-openapi-docs의 구조와 관계 4. Docusaurus 커스터마이징 - swizzle을 중심으로 1. Docusaurus swizzling에 대한 이해 2. 커스터마이징 요구사항과 구현 5. Typesense로 검색 시스템 구축 1. Typesense 도입 배경 및 특징 2. 검색 시스템 구성 3. 커머스API 문서 크롤링 4. 커머스API 문서 버전 별 검색 정책 6. 문서 배포 프로세스 구축 1. Nubes를 이용한 정적 자원 배포 전략 2. Docusaurus 빌드 및 크롤링 수행 환경 구성 3. 최종 문서 배포 흐름 7. 결과 비교 및 사용자 경험 1. 결과 비교(ui, 다크모드, 검색) 2. 웹페이지 성능 비교 3. 사용자 경험 변화 8. 마치며 1. 긍정적인 경험 2. 앞으로 남은 과제