Docusaurus를 이용한 API 문서 플랫폼의 진화

문제 상황

• 기존 Redoc 기반 커머스API 문서 사이트의 UX·사용성 한계
• 커스터마이징과 문서 운영, 배포 프로세스의 어려움

해결 방법

• Docusaurus와 docusaurus-openapi-docs를 채택해 문서 플랫폼 재구성
• Typesense로 검색 시스템을 구축하고 문서 크롤링·버전별 검색 정책을 설계
• Nubes 기반 정적 자원 배포와 빌드·크롤링·배포 흐름 정리

성능/운영 포인트

• ui, 다크모드, 검색 경험 개선
• 웹페이지 성능 비교와 정성·정량 결과 확인

적용해볼 점

• API 문서 사이트의 커스터마이징과 배포 자동화에 Docusaurus 적용 가능성 검토
• 검색 품질과 문서 버전 관리까지 포함한 운영 구조 설계 필요