문서는 어떻게 업데이트되나요

문서 업데이트 흐름

Support 문서는 원문(raw) 수집부터 production 반영까지 아래 단계를 거칩니다.

raw 수집 → 초안 생성 → 사람 검수 → docs 반영 → 빌드 → staging → 승인 → production

1. raw 수집

PRD, TC, 코드, 정책 원문을 raw/inbox/에 수집합니다.
지원 형식: .md, .txt, .json

2. 초안(draft) 생성

pnpm raw:generate 명령으로 raw 파일을 MDX 초안으로 변환합니다.
생성된 파일은 raw/generated/ 에 저장됩니다.

3. 사람 검수

생성된 초안을 담당자가 검토합니다.
내용 확인 후 status를 review 또는 approved로 변경합니다.

4. docs 반영

검수가 완료된 파일을 src/content/docs/ 하위 적절한 카테고리로 이동합니다.

5. 빌드 및 staging 배포

main 브랜치 머지 시 GitHub Actions가 자동으로 빌드하고 staging 환경에 배포합니다.

6. 승인 및 production 배포

staging에서 내용을 최종 확인한 후, 담당자 승인을 거쳐 production에 배포합니다.

---

문서 상태 모델

각 문서의 status 필드는 아래 값 중 하나를 가집니다.

상태	설명
draft	초안. 자동 생성 또는 작성 중인 문서
review	검수 중. 담당자 검토가 필요한 문서
approved	승인 완료. staging 또는 production 반영 대상
published	배포 완료. 현재 사이트에서 공개 중인 문서

production validator는 draft 상태 문서가 main 브랜치에 포함될 경우 경고를 출력합니다.

---

frontmatter 검증

모든 문서는 아래 필드를 포함해야 합니다.

title: "문서 제목"
description: "검색 결과와 메타 설명에 사용될 요약"
status: "draft"  # draft | review | approved | published
owner: "Product"
lastReviewedAt: "2026-06-15"

title 또는 description이 누락되면 pnpm validate:frontmatter가 실패합니다.