DOCS-CDR-0001: 번역 산출 규약과 저작권 고지 기준

개정 이력

채택 이후의 본문 개정 내역이다. 아래 개정은 §2.2 판정 기준의 정의를 확장한 것으로, 결정의 방향(라이선스 축과 저작물 성격 축의 분리, 고지 정확성 우선)은 채택 시점 그대로이며 판정 축이 불완전했던 것을 바로잡는다.

• 2026-07-25: §2.2 translation_fidelity 판정 기준에 "내용 추가" 축을 신설. 종래 정의는 원문 절의 배치만을 판정 축으로 삼아, 원문에 없는 다이어그램·학습 인사이트·종합 결론을 더한 문서가 절 순서만 지키면 faithful로 판정되는 결함이 있었다. 판정 축을 절 배치와 내용 추가 둘로 확장하고, 둘 중 하나라도 해당하면 restructured로 확정한다. 연동해 §1.3 관측 서술, 변경 표시 문구 정의(§2.3), 대안 표(§3), 후속 1(§5)을 새 기준에 맞춰 수정했다. 발행본 15편의 선언값과 변경 문구를 실제에 맞추는 작업이 후속 1로 남는다.

항목	내용
상태	proposed
결정자	Davi
기간	2026-07-24 ~
관련 결정	DOCS-ADR-0004, DOCS-ADR-0003, CORE-ADR-0001
대체 관계	없음

1. 맥락 (Context)

1.1 규약의 소재

번역 문서의 산출 규칙은 현재 translation-archive 스킬에만 존재한다. 스킬은 실행 도구이고 도구는 개정과 교체를 겪는다. 지금 상태에서 스킬을 갈아엎으면 규칙의 근거가 함께 사라지며, 왜 그렇게 정했는지를 되짚을 자리가 없다.

결정 기록과 집행 도구의 관계는 이미 선례가 있다. DOCS-ADR-0002가 규범을 정하고 DOCS-ADR-0003이 집행 구조를 정하며 rules.ts가 데이터를 담는다. 번역 규약도 같은 층위 분리를 적용한다.

1.2 판정 축의 혼재

스킬 워크플로 1단계는 소스 유형을 official-docs, reference, blog로 나눈다. 이 분류에 두 종류의 사실이 섞여 있다. 하나는 번역과 재배포가 허락되는지이고, 다른 하나는 원문이 사양 문서인지 저술인지다.

두 사실은 직교한다. Medium 글이 막히는 이유는 저술이라서가 아니라 라이선스가 전권 보유(all rights reserved)라서다. 반대로 Raft 논문은 저술이지만 CC BY 4.0이라 번역할 수 있다. 축을 섞으면 "공식 문서니까 괜찮다" 같은 잘못된 추론이 성립한다.

라이선스 축은 스킬의 license-triage.md가 판정표와 게이트 절차까지 갖추고 있다. 비어 있는 것은 저작물 성격 축이고, 그 축이 결정해야 할 대상은 번역 방식이다.

1.3 번역 방식 규칙의 부재

스킬 워크플로 3단계는 두괄식 재구성을 조건 없이 지시한다. 논문과 블로그에는 적합하나 사양 문서에는 해롭다. 사양 문서의 절 순서는 서술 편의가 아니라 의존 관계이며, 재배치하면 원문과의 대조가 끊기고 독자가 원문의 특정 절을 찾을 수 없다.

translation_fidelity 필드는 이미 존재하고 faithful과 restructured 두 값을 갖는다. 없는 것은 어느 쪽에 무엇을 쓰는지의 기준이며, 그 결과 판단이 문서마다 즉흥적으로 이뤄졌다.

발행본을 읽어 확인한 사실이 이 공백을 보여준다. 여러 발행본이 원문에 없는 종합 결론, 대응 도형이 없는 다이어그램, 학습 관점의 인사이트 절을 담고 있으면서도 절 순서만을 근거로 faithful로 판정되어 있었다. 판정 축이 절 배치 하나뿐이라, 원문에 없는 내용을 더한 사실이 판정에 반영되지 않은 것이다. 절 순서를 지켰다는 것과 원문을 충실히 옮겼다는 것은 다른 문제이며, 기준이 전자만 보면 후자의 위반을 감지할 수 없다.

1.4 고지 항목의 누락

현행 attribution 블록은 CC BY 4.0이 요구하는 세 가지, 곧 저작자표시와 라이선스 링크와 변경 표시를 담고 있다. 라이선스 준수 자체에는 결함이 없다.

빠진 것은 라이선스가 요구하지 않는 두 가지다. 이 번역이 비공식이라는 사실과, 원문과 어긋날 때 원문이 우선한다는 사실이다.

두 항목이 필요한 이유는 준수가 아니라 위험 관리다. Kubernetes에는 공식 한국어 로컬라이제이션이 별도로 존재하고(kubernetes.io/ko), 검색 결과에서 두 문서가 나란히 노출된다. 번역 대상이 운영 절차를 다루는 문서일 때, 오역이나 원문 갱신 누락이 독자의 운영 사고로 이어질 수 있다.

1.5 발행 산출물의 작성 지시 노출

발행본 k8s-node-allocatable의 역자 주 적용 절 말미에 경험 슬롯이 비어 있는 채로 남아 있고, 그 안의 작성 지시 문구가 독자에게 그대로 렌더된다. 스킬 체크리스트는 이 슬롯을 REVIEW-REQUIRED 주석과 함께 비워 두라고 규정하는데, 주석이었다면 렌더되지 않았을 것이다. 템플릿이 가시 텍스트를 쓰는지 변환 과정에서 주석이 풀렸는지는 확인하지 않았다.

원인과 무관하게, 발행 상태의 문서가 작성용 비계를 노출하는 상태는 규약으로 막아야 한다.

2. 결정 (Decision)

2.1 두 축의 분리

번역 판정을 두 축으로 분리하고 각 축이 결정하는 대상을 고정한다.

축	값	결정 대상
라이선스	허용 / 조건부 / 불허	게시 가부
저작물 성격	사양 문서 / 저술	번역 방식

라이선스 축이 선행 게이트다. 불허 판정은 저작물 성격과 무관하게 즉시 중단이며, notes 재작성 경로로 넘긴다.

라이선스 판정표와 게이트 절차의 정본은 스킬의 license-triage.md다. 이 문서는 축의 존재와 선후 관계만 정하고 판정표를 복제하지 않는다. 복제하면 두 사본이 갈라지고, 갈라진 시점을 아무도 알아채지 못한다.

저작물 성격 축의 값은 다음과 같이 판정한다.

• 사양 문서: 공식 레퍼런스, 표준 문서, 프로젝트 공식 가이드. 절의 순서가 개념의 의존 관계를 표현한다
• 저술: 논문, 블로그, 해설 기사. 절의 순서가 저자의 서술 편의를 표현한다

같은 사이트 안에서도 문서마다 다를 수 있다. 사이트 단위가 아니라 문서 단위로 판정한다.

2.2 translation_fidelity 판정 기준

두 값의 정의를 다음으로 확정한다. 판정 축은 둘이다. 원문 절의 배치를 바꾸었는가, 그리고 원문에 없는 내용을 더했는가. 두 축 중 하나라도 해당하면 restructured다.

faithful: 원문을 충실히 옮기기만 한다. 두 조건을 모두 지킨다. 첫째, 원문 절의 순서와 계층을 보존한다. 원문의 절을 옮기거나 합치거나 나누지 않는다. 둘째, 원문에 없는 내용을 더하지 않는다. 종합 결론, 원문에 대응 도형이 없는 다이어그램, 학습 관점의 해설, 원문이 잇지 않은 개념 연결은 모두 추가에 해당한다. 역자의 개입은 번역 보조 수준에 한정한다. 용어 풀이, 원문 링크의 목록화, 짧은 번역 각주가 그 범위다.

restructured: 원문 절을 재배치·병합하거나, 원문에 없는 내용을 더한다. 두괄식 결론 종합, 다이어그램 창작, 학습 인사이트 절, 개념 연결의 삽입이 후자에 해당한다. 정보 전량 보존 원칙은 그대로 적용되며, 재배치도 추가도 요약의 허가가 아니다.

두 값을 가르는 것은 재구성의 강도가 아니라 종류다. 절 순서를 그대로 두었더라도 원문에 없는 다이어그램이나 학습 인사이트를 더했다면 restructured다. 이 문서 저자의 번역은 학습 흐름과 인사이트 논점을 만드는 것을 목적으로 삼으므로, 대부분 restructured에 속한다.

판정 규칙은 다음과 같다.

1. 저작물 성격이 사양 문서이면 원문 절의 배치는 faithful을 의무로 한다. 단 학습 목적의 내용 추가(다이어그램, 인사이트 절)를 하면 그 문서는 restructured이며, 이는 사양 문서에도 허용된다. 사양 문서에서 금지되는 것은 절의 재배치이지 내용의 추가가 아니다
2. 저술이면 restructured를 허용하되, 원문에 아무 추가도 하지 않고 절 순서도 지켰다면 faithful이다
3. 판정이 애매하면 restructured를 택한다. 원문에 없는 내용을 더했는지 불확실하면 더한 것으로 간주한다

3번을 두는 이유는 고지의 정확성 때문이다. faithful이라 선언한 문서에 실제로는 원문에 없는 다이어그램이나 해설이 있으면, 독자는 그 내용을 원문의 것으로 오인한다. 타인 저작물을 다루는 번역에서 이 오인은 저작권 고지의 부정확으로 이어진다. 반대로 restructured라 선언한 문서가 실제로는 충실한 번역이어도, 독자가 원문 대조를 한 번 더 할 뿐 오인은 없다. 후자의 비용이 작다.

2.3 attribution 블록 고지 항목

블록은 다음 항목을 담는다. 앞의 세 항목은 라이선스 의무이고, 뒤의 두 항목은 자율 고지다. 두 성격을 구분해 기록하는 이유는 라이선스가 CC BY 계열이 아닐 때 무엇이 협상 불가이고 무엇이 자체 기준인지 판단하기 위해서다.

구분	항목
라이선스 의무	원저자와 원문 링크
라이선스 의무	라이선스 명칭과 링크
라이선스 의무	변경 사실의 표시
자율 고지	비공식 번역이며 원저작자와 프로젝트의 공인을 받지 않았다는 사실
자율 고지	원문과 번역이 어긋날 경우 원문이 우선한다는 사실

동일조건변경허락(SA) 계열 라이선스는 산출물의 동일조건 배포 고지가 의무에 추가된다. 판정은 license-triage.md가 한다.

라이선스 표기의 기본은 단일이다. 저장소 루트의 라이선스 파일이 그 저장소의 콘텐츠 전부에 적용되며, 마크다운 본문과 그 안에 담긴 코드 예시를 구분하지 않는다.

본문과 코드를 나눠 표기하는 조건은 하나다. 서로 다른 라이선스가 적용된다는 사실을 명시한 파일이나 고지를 실물로 확인했을 때만 분기한다. LICENSE-CODE나 LICENSE.docs 같은 별도 파일이 그것이다. 확인하지 못하면 단일 표기로 간다. 침묵은 예외의 근거가 아니다.

분기를 적을 때 두 링크는 서로 다른 실제 파일을 가리켜야 한다. 같은 파일을 두 라이선스의 근거로 제시하면 둘 중 하나는 거짓이다.

과잉 고지는 부족 고지와 같은 무게의 결함이다. 없는 분기를 적으면 그 자체가 허위 고지이며, 라이선스 준수 실패와 다르지 않게 취급한다.

변경 표시 문구는 translation_fidelity 값과 일치해야 한다. faithful 문서에 재구성했다고 적거나, 원문에 없는 다이어그램을 더한 restructured 문서에 충실히 옮겼다고만 적으면, 그 자체가 부정확한 고지가 된다. 문구는 두 값에 대해 각각 고정한다.

• faithful: 원문의 절 순서와 내용을 보존해 옮기고 번역 보조 주석을 더했다
• restructured: 원문을 학습 목적으로 재구성하고 역자 주와 다이어그램을 더했다

restructured 문구의 "재구성"은 절 재배치와 내용 추가를 함께 포괄한다. 문서가 절 순서는 지키되 다이어그램·인사이트만 더한 경우에도 이 문구를 쓴다. 실제 변경의 종류(재배치인지 추가인지, 무엇을 더했는지)는 문구 뒤에 이어 적어 구체화한다.

원문 시점과 번역 시점을 함께 표기한다. 원문 시점은 번역 기준이 된 원문의 최종 수정 시점이며, 갱신된 원문과의 차이를 판정하는 기준점이다. 값은 original_published가 담는다.

2.4 본문 순수성

본문에는 원문에서 유래한 내용만 담는다. 역자가 교차검증 과정에서 얻은 사실, 원문에 없는 배경 설명, 역자의 판단은 전부 역자 주로 분리한다.

근거는 두 가지다. 독자가 어디까지가 원문이고 어디부터가 역자인지 구분할 수 있어야 하며, 이는 CC BY의 변경 표시 취지와도 맞닿는다. 그리고 원문이 갱신됐을 때 대조 대상이 본문으로 한정되어야 갱신 반영이 가능하다.

역자 주 유형은 검증, 정정, 주의, 보충, 적용 다섯으로 한다. 배치와 문체 규칙은 스킬의 body-template.md가 정본이다.

적용 유형의 경험 슬롯은 실제 실습과 검증을 거친 내용만 담는다. 추론으로 채우지 않는다. 이 슬롯이 비어 있다는 사실 자체가 아직 손으로 확인하지 않았다는 정보를 담으므로, 채워 넣으면 그 정보가 사라진다.

2.5 발행 게이트

초기값은 draft: true와 ai_assistance.review: "unreviewed"로 고정한다. frontmatter-conventions §6 게이트 규칙의 적용이다.

draft: false 전환의 조건은 다음 전부다.

1. 역자 주의 사실관계를 직접 확인했다
2. IMG-SLOT을 전부 처리했다. 재작도, 생략과 원문 안내, 라이선스 허용 시 사본 중 하나로 판정한다
3. 비어 있는 REVIEW-REQUIRED 슬롯을 처리했다. 내용을 채우거나, 슬롯 자체를 제거하거나, 렌더되지 않는 형태로 남긴다
4. attribution 블록의 다섯 항목이 있고 변경 표시 문구가 translation_fidelity와 일치한다

3번이 §1.5의 대응이다. 발행 상태의 문서는 작성용 지시 문구를 렌더하지 않는다. 슬롯을 남길 때는 HTML 주석으로 둔다.

2.6 번역 제외 대상

라이선스가 허용해도 번역하지 않는 문서를 규정한다.

• 자동 생성된 API 레퍼런스. 필드 나열이라 정독 수익이 없고 릴리스마다 갱신되어 번역이 즉시 낡는다
• 실습 튜토리얼. 읽는 문서가 아니라 실행하는 문서다
• alpha와 beta 단계 기능 문서. 번역 완료 전에 사양이 바뀔 확률이 높다

번역 대상의 선정 우선순위는 학습 목표에 따라 바뀌므로 이 규약이 정하지 않는다. 위 세 항목만 상시 제외로 둔다.

2.7 소급 처리

발행된 번역 문서의 본문은 고치지 않는다. 다음 두 가지만 감사한다.

1. translation_fidelity 선언값이 실제 본문 형태와 일치하는지 확인하고, 어긋나면 선언값을 실제에 맞춘다
2. attribution 블록에 자율 고지 두 항목을 추가하고, 변경 표시 문구를 §2.3의 고정 문구로 교체한다

본문을 재작성하지 않는 이유는 비용 대비 효용이다. 이미 발행된 재구성 번역의 문제는 재구성했다는 사실이 아니라 그 사실이 부정확하게 고지된 것이며, 고지를 고치면 해소된다.

2.8 스킬 개정 지시

translation-archive 스킬은 이 규약의 집행자다. 다음을 개정한다.

대상	개정 내용
워크플로 1단계	소스 유형 분류를 라이선스 축과 저작물 성격 축으로 분리한다. 성격 판정 결과로 translation_fidelity를 확정하고 그 근거를 기록한다
워크플로 3단계	fidelity 값에 따라 분기한다. faithful이면 원문 절의 순서와 계층을 보존하고 원문에 없는 절을 원문 절 사이에 끼우지 않는다
워크플로 6단계	category를 원문 주제로 채우고 translation 값을 금지한다. order를 기입한다(DOCS-ADR-0004 §2.2, §2.3)
attribution 템플릿	자율 고지 두 항목을 추가하고 변경 표시 문구를 fidelity별로 분기한다
REVIEW-REQUIRED 슬롯	렌더되지 않는 형태로 표기한다
최종 체크리스트	fidelity와 attribution 문구의 정합, 자율 고지 존재, category 값, 슬롯의 비렌더 여부를 항목으로 추가한다

라이선스 게이트, 역자 주 다섯 유형, IMG-SLOT, 정보 전량 보존 원칙은 개정하지 않는다. 의도대로 작동하는 것을 발행본에서 확인했다.

3. 검토한 대안과 기각 이유

대안	내용	기각 이유
규약을 스킬에만 둔다	현행 유지	도구 개정 시 규칙의 근거가 함께 사라진다. 왜 그렇게 정했는지를 되짚을 자리가 없다
판정표를 CDR에 복제	license-triage.md 내용을 본문에 옮긴다	두 사본이 갈라지고 갈라진 시점을 감지할 수 없다. 단일 진실 원천 원칙 위반
공식 문서와 창작물의 단일 축	출처 종류 하나로 가부와 방식을 함께 결정	두 사실이 직교하므로 "공식이면 괜찮다"류의 잘못된 추론이 성립한다
사양 문서에도 두괄식 허용	현행 스킬 동작 유지	절 순서가 의존 관계를 표현하는 문서에서 원문 대조가 끊긴다
fidelity 값 신설	내용 추가와 절 재배치를 구분하는 세 번째 값	값이 늘면 판정 비용이 오른다. 두 종류의 재구성을 restructured 하나로 묶고 변경 문구 뒤에 종류를 적는 것으로 같은 구분이 표현된다
발행본 본문 소급 재작성	재구성·추가된 번역을 원문 그대로로 되돌린다	학습 흐름과 인사이트를 만드는 것이 이 번역의 목적이므로 되돌림은 목적 자체를 폐기한다. 문제는 재구성이 아니라 부정확한 고지이며, 고지 교정으로 해소된다
비공식 고지 생략	라이선스 의무만 이행	공식 로컬라이제이션과의 오인 여지가 실재하고, 운영 절차 문서의 오역 위험이 남는다

4. 결과 (Consequences)

4.1 기대 효과

번역 방식이 문서마다의 즉흥 판단에서 규칙으로 옮겨간다. 사양 문서의 절 구조가 보존되어 원문 대조가 가능해지고, 원문 갱신 시 반영 대상을 특정할 수 있다.

라이선스 준수 항목과 자율 위험 관리 항목이 구분되어, CC BY가 아닌 라이선스를 만났을 때 무엇이 협상 불가인지 판단할 수 있다.

발행 게이트가 열거되어 draft 해제가 감으로 이뤄지지 않는다. 작성용 비계가 독자에게 노출되는 상태가 규약으로 막힌다.

규약과 집행 도구가 분리되어, 스킬을 개정하거나 교체해도 규칙의 근거가 남는다.

4.2 감수 비용

번역 착수 전 판정 단계가 하나 늘어난다. 저작물 성격과 절 순서의 성격을 판단하고 근거를 남기는 작업이다.

faithful 문서는 원문 구조를 따르므로 읽기 흐름이 두괄식보다 불편할 수 있다. 원문 대조 가능성과 맞바꾼 비용이다.

발행 11편의 attribution 블록을 손봐야 하고, fidelity 선언값 감사가 문서별 본문 확인을 요구한다.

규약과 스킬 두 곳을 함께 유지하게 된다. 스킬 개정 시 이 문서와의 정합을 확인하는 절차가 추가된다.

4.3 변경 제외 범위

라이선스 판정표, 역자 주 다섯 유형의 배치와 문체 규칙, IMG-SLOT 처리 절차, 정보 전량 보존 원칙은 건드리지 않는다. 각각 스킬의 참조 문서가 정본이다.

디렉터리 구조, URL 체계, 사이드바 설정, 카테고리 필터는 DOCS-ADR-0004 관할이다.

번역 대상의 선정 우선순위, 발행된 문서 본문의 재작성, 원문 이미지 처리 정책(image-rules §E), notes 재작성 경로의 세부는 다루지 않는다.

5. 후속 (Follow-ups)

1. 발행본 15편을 §2.2의 두 축(절 배치, 내용 추가)으로 재판정하고 translation_fidelity 선언값과 변경 표시 문구를 실제에 맞춘다. 절 순서 대조는 원문 목차와 직접 수행하며, 내용 추가는 원문에 없는 다이어그램·인사이트·종합 결론의 유무로 판정한다. 이 문서 저자의 번역은 학습 목적의 내용 추가를 포함하므로 대부분 restructured로 판정될 것이다.
2. §1.5의 원인 특정. 스킬 템플릿이 가시 텍스트를 쓰는지, 변환 과정에서 주석이 풀리는지 확인한다.
3. image-rules §E의 정리. 현재 §E는 원문 이미지 정책과 미결 작업 항목이 한 문단에 섞여 있다. 정책만 남기고 작업 항목은 결정 기록의 후속으로 옮긴다.
4. docMeta.config.ts의 TRANSLATION_FIELDS에 original_published와 translation_fidelity 추가. 로더에 싣지 않은 필드는 화면에 없는 필드라는 컨벤션의 적용이며, fidelity가 카드에 노출되면 선언과 실제의 어긋남을 발견하기 쉬워진다.
5. docLint 규칙 후보 등재: translations-fidelity-required, translations-notice-required. DOCS-ADR-0004 §2.6의 규칙군에 이어 붙인다. 다만 고지 문구의 존재 검사는 본문 문자열 검사라 DOCS-ADR-0003 §4.3의 제외 범위와 닿으므로, 검사 가능 여부를 먼저 판정한다.
6. 본문과 코드의 라이선스가 실제로 갈리는 출처를 만났을 때의 frontmatter 표현. 현재 license 필드는 단일 값이다. kubernetes.io는 이 사례가 아님이 확인됐으므로 (2026-07-24, LICENSE-CODE 부재) 실제 사례가 나타날 때까지 유예한다.

6. 참고 출처

• Creative Commons, Attribution 4.0 International (한국어 요약): https://creativecommons.org/licenses/by/4.0/deed.ko
• Creative Commons, CC BY 4.0 법적 문안(2차적저작물 정의): https://creativecommons.org/licenses/by/4.0/legalcode
• kubernetes/website, LICENSE: https://github.com/kubernetes/website/blob/main/LICENSE
• Kubernetes, 한국어 공식 문서: https://kubernetes.io/ko/docs/home/
• Kubernetes, Localization 가이드: https://kubernetes.io/docs/contribute/localization/
• 저작권법 제22조(2차적저작물작성권): https://www.law.go.kr/법령/저작권법