멀티플랫폼 문서를 관리하는 한 가지 방법, 싱글 소싱

핵심 내용

• LINE Planet 문서 사이트에 싱글 소싱을 적용해 멀티플랫폼·다국어·버전 관리 문서를 공유 소스 기반으로 운영한 사례
• 조건부 콘텐츠, 변수 처리, 콘텐츠 재사용을 조합해 플랫폼별 문서를 생성하고 복사·붙여넣기와 오류를 줄이는 구조
• Docusaurus 멀티 인스턴스와 마크다운 임포트, React 컴포넌트와 메타데이터를 활용해 플랫폼별 API 이름, 상위 요소 표시, 레퍼런스 링크까지 처리
• 모든 문서에 적용하기보다 개념 가이드와 확장 기능 가이드 중심으로 적용하고, 튜토리얼 성격 문서는 제외하는 제약과 효과 정리

적용해볼 점

• 플랫폼, 버전, 언어처럼 반복되는 맥락이 많을 때 공유 문서와 메타데이터 분리 검토
• 조건부 구문과 변수화로 문서 차이를 코드처럼 관리하는 방식 고려
• 문서 구조를 표준화할 수 있는 영역부터 단계적으로 적용