콘텐츠로 이동

버전 정책

콘텐츠는 시간이 지나면 낡습니다. 무겁지 않게, 그러나 빠짐없이 관리하는 2단계 모델을 씁니다.

1단계 — 페이지별 버전 메타 (기본)

섹션 제목: “1단계 — 페이지별 버전 메타 (기본)”

frontmatter의 ue_version(작성 기준) · ue_verified(마지막 재검증) · updated(일자) · status로 관리합니다. 페이지 상단에 “UE 5.6 · 마지막 확인 2026-05-29” 배너를 달고, 새 UE 메이저가 나왔는데 재검증 못 했다면 status: needs-update로 노란 경고를 띄웁니다. 95%의 노후화를 이 방식으로, 거의 추가 비용 없이 처리합니다.

2단계 — 사이트 전체 버전 (필요할 때만)

섹션 제목: “2단계 — 사이트 전체 버전 (필요할 때만)”

UE 메이저 변화가 다수 페이지를 한꺼번에 깨뜨릴 때에 한해 /5.6/, /6.0/ 같은 전체 버전 트리를 도입합니다. 런칭 시점엔 도입하지 않습니다(유지보수가 N배가 됨). 이 경로가 필요해지면 네이티브 버전 관리가 강한 Docusaurus로의 이전을 검토합니다.

스냅샷보다 한 주제당 한 페이지를 제자리에서 갱신하는 방식을 기본으로 합니다. 이력은 Git에 남고, 독자는 항상 최신 검증 상태를 봅니다. 1인 운영·고유지보수성에 가장 잘 맞습니다.

  • ue_verified가 현재 UE보다 뒤처지거나 updated가 ~12개월 이상 지난 페이지를 CI가 목록화 → 분기별로 재검증/deprecated 처리/갱신 중 선택.
  • 공유된 URL은 절대 조용히 삭제하지 않는다. deprecated로 표시하고 배너로 경고하며, 필요하면 리다이렉트.
  • 위키 단위의 큰 추가/개편은 변경 이력에 별도로 기록.