핵심 요약
NAVER D2의 API 문서 플랫폼을 Docusaurus와 Typesense로 진화시켜 Redoc 기반 커머스API 문서를 현대적인 구조로 전환했습니다. 이 과정에서 Docusaurus 채택 배경과 오픈소스 생태계 활용, Typesense를 통한 검색 시스템 구축, 배포 프로세스의 재정의를 핵심으로 다루었습니다.
구현 방법
- Docusaurus 도입 배경 및 오픈소스 선정, Docusaurus와 docusaurus-openapi-docs의 구조와 관계, swizzle를 중심으로 한 커스터마이징 이해
- Typesense 도입 배경 및 검색 시스템 구성, 커머스API 문서 크롤링 및 버전별 검색 정책 수립
- 문서 배포 프로세스 구축, Nubes를 이용한 정적 자원 배포 전략, 빌드 및 크롤링 환경 구성과 최종 문서 배포 흐름
주요 결과
- 결과 비교 및 사용자 경험 변화(UI, 다크모드, 검색) 확인
- 웹페이지 성능 비교를 통한 개선 포인트 도출
- 배포 흐름 및 인프라 구성의 재정의로 운영 방향 제시
