기술 문서 사이트로 Docusaurus 활용하기

기술 문서 사이트로 Docusaurus 활용하기

2
AI 요약

이 글은 AI가 원문을 분석하여 핵심 내용을 요약한 것입니다.

기술 문서 사이트로 Docusaurus 활용하기

이 게시물은 LINE의 문서 엔지니어링 경험을 바탕으로 팀 공용 SSG인 Docusaurus를 선정하고 커스터마이징한 과정을 공유합니다.

SSG 선정 배경과 기준

  • 기본 문서 기능 충실 및 새 기능 자유 추가 가능
  • docs as code 방식을 지원하며 React 기반을 선호
  • 2세대 SSG 중 Docusaurus를 선택, VuePress도 대안으로 언급

커스터마이징 사례

  • Markdown 표 내 줄 바꿈과 목록 처리 위해 MultilineTable 컴포넌트 개발
  • 용어집과 API 문서용 YAML 데이터 관리 및 전역 컴포넌트 구현
  • 문서 뷰와 데이터를 분리해 작업 효율 극대화

향후 계획

  • 사용자 편의를 위한 템플릿 및 안내서 마련 예정
  • 필요 시 다른 SSG로의 유연한 전환도 고려