생성된 문서 병합 전 제품 사실에 인간의 소유권 표시

모델이 사실을 임의로 지어내도록 허용될 경우 생성된 문서는 실패합니다. 유용한 분리는 스타일적인 것이 아니라 운영적인 것이므로, 검토자는 초안 작성 시작 전에 이를 수정해야 합니다. 모델은 페이지 구조, 섹션 전환, 그리고 코드 예제를 초안으로 작성할 수 있으며, 이는 실행되지 않은 제안으로 레이블이 지정되어 유지됩니다.

독자가 의존할 수 있는 버전, 제한 사항, 보안 경계 및 모든 가용성 진술에 대해서는 인간이 소유권을 가져야 합니다. 이러한 분리를 건너뛰는 팀은 매끄럽게 읽히지만 현재 제품이 제공하는 것을 여전히 잘못 명시하는 페이지를 배포합니다. 이 워크플로우는 원본 모델 출력을 기록의 원천으로 취급하지 않으면서도 생성된 초안을 유용하게 유지합니다.

왜 설정 페이지가 표류하는가

설정 페이지는 로컬 절차와 제품 주장을 혼합하며, 이 두 가지 종류의 문장은 다르게 노화됩니다. 로컬 명령어는 알려진 커밋의 저장소와 비교할 수 있는 반면, 할당량과 서버 제공 사항은 그 커밋 외부에서 변경됩니다. 만약 모델이 한 번에 두 가지 종류를 작성한다면, 검토자는 어조를 편집하는 경향이 있어 지원되지 않는 숫자를 놓치기 쉽습니다. 실패는 어색하거나 미완성된 산문이라기보다는 소유권이 없는 주장(unowned claims)의 개수로 측정될 수 있습니다.

생성된 개인 사이트의 공개적인 작성물은 다른 페이지 형식에서도 동일한 소유권 격차를 보여줍니다. 페이지가 완성된 것처럼 보일지라도 그 사실적 계층(factual layer)이 특정 인물에게 할당되지 않은 경우가 있습니다. 문서화 팀은 이러한 패턴을 초안 도구를 금지할 이유가 아니라 검토 결함으로 취급해야 합니다. 해결책은 어떤 생성된 단락이 브랜치에 수용되기 전에 소유권을 결정하는 레지스터입니다.

모델이 작성할 수 있는 것

검토자는 아래 표를 산문 스타일 가이드가 아니라 병합 게이트(merge gate)로 사용해야 합니다. 문장은 거짓 진술이 로컬 테스트나 명시적인 제안 레이블에 의해 포착될 때만 모델로 이동합니다. 그 외의 모든 것은 기본 출처(primary source)가 해당 행에 첨부될 때까지 이름이 지정된 인간 소유자에게 남아 있습니다.

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

| 주장 유형 | 모델이 초안 작성 가능 | 인간이 소유해야 함 | 병합 전 게이트 | :--- |
| 제목 개요 및 섹션 순서 | 예 | 개요 검토 | 제목 안에 제품 사실 포함 금지 |
| ... |

할당량, 기간, 하드웨어 참고 사항, 모델 메뉴는 공급업체 브리프가 구체적으로 들리더라도 인간 소유 영역에 머무릅니다. 검토자는 출판일에 검색된 기본 페이지에서 해당 문장만 복사하여 행에 URL을 저장합니다. 만약 그 페이지가 공백이라면, 생성된 초안은 설정 섹션이 완전하게 느껴지도록 숫자를 지어내서는 안 됩니다. 동일한 블록은 순위, 영속성 언어, 그리고 제안이 내일 변경되면 거짓이 되는 모든 주장에 적용됩니다.

작업 분류 (Worked classification)

호스팅된 도구에 대한 생성된 설정 가이드에서 자주 함께 나타나는 다음 세 문장을 고려해 보세요. 첫 번째 문장은 독자가 편집할 로컬 파일을 나열하며, 경로가 고정 커밋(frozen commit) 시점에 존재한다면 초안 작성될 수 있습니다. 두 번째 문장은 무료 서버 옵션이 존재한다고 말하며, 현재 문서 URL이 행에 저장될 때까지 인간 소유로 유지됩니다. 세 번째 문장은 토큰 양을 명시하며, 출판일에 기본 출처가 해당 양을 명시할 때까지 차단됩니다.

세 번째 블록은 의도적인 것인데, 아웃리치 브리프(outreach brief)는 기본 출처가 아니며 검토가 끝나기 전에 구식이 될 수 있기 때문입니다. 동일한 규칙은 하드웨어 형태, 시간 제한, 모델 식별자 및 다른 도구와의 모든 순위에 적용됩니다. 만약 출판일에 출처가 누락되면, 추측된 수치를 게시하는 대신 문장 없이 페이지가 배포됩니다.

번호 매긴 워크플로우 (Numbered workflow)

순서대로 6단계를 따르고, 레지스터 행(register rows)이 존재할 때까지 모델에게 산문(prose)을 요청하지 마십시오.

1. 레포지토리 커밋, 문서 경로, 그리고 사람이 인용할 모든 제품 페이지를 기록하여 소스 세트를 동결합니다.
2. 각 주장이 한 줄을 차지하고 생성 전에 소유자 스탬프를 받을 수 있도록 후보 문장을 추출합니다.
3. 각 줄을 model_draft, human_own, 또는 blocked로 분류하고, 현재 사람이 소유한 모든 사실에 출처를 첨부합니다.
4. 제목(headings), 전환어(transitions), 그리고 proposal 레이블이 붙은 예시만 요청하여 초안을 작성한 후, 동결된 사람의 줄은 변경 없이 다시 붙여넣습니다.
5. 초안을 레지스터와 비교하고, 차단된 주장이 나타나거나 사람이 작성한 줄이 의역되었을 경우 페이지를 실패 처리합니다.
6. 제품 사실을 방어할 수 있는 사람의 승인을 요구하며, 그 승인이 있을 때까지 모델 출력은 초안으로 표시됩니다.

이 순서는 생성 비용은 저렴하지만 나중에 공개적으로 수정하는 것이 비싸기 때문에 의도적으로 엄격하게 유지됩니다. 사람이 소유한 행을 설명할 수 없는 검토자는 어떤 모델 문장이 확장되기 전에 페이지를 반송해야 합니다. 그 거부에서 나온 공유된 메모는 다음 초안이 조용히 삭제할 수 있는 채팅 기록에 속하는 것이 아니라 레지스터에 속합니다.

레지스터 검사기 (Register checker)

아래 스크립트는 로컬 리뷰 제안이며, 실행된 벤치마크의 기록은 아닙니다. 이 스크립트는 JSON 레지스터와 마크다운 초안을 읽은 다음, 소유되지 않은 제품 언어가 스탬프가 찍힌 줄 밖에 있을 경우 0이 아닌 값으로 종료됩니다. 샘플 목록을 제품 사양처럼 취급하기보다는 자체적으로 지원하지 않는 주장(unsupported claims)에 맞게 금지 토큰 목록을 조정하세요. 이 검사기는 도구(tools) 아래에 저장하여 리뷰와 공유 서버 작업 공간에서 동일한 명령이 실행될 수 있도록 합니다.

#!/usr/bin/env python3
"""제안: 생성된 문서 초안에서 소유되지 않은 제품 주장을 플래그 지정합니다."""
import json
...

매칭 레지스터(matching register)는 검토자가 한 번의 패스 동안 소유한 모든 문장을 읽을 수 있을 만큼 작게 유지되어야 합니다. 각 행은 레인 이름, 인간이 방어할 정확한 문장, 그리고 스탬프를 정당화한 출처를 명시합니다. 실제 검토에서 체커가 통과하도록 허용되기 전에 플레이스홀더 커밋(placeholder commit)과 URL을 교체하십시오.

{
"commit": "REPLACE_WITH_REVIEWED_SHA",
"claims": [
...

초안이 존재하는 후 리포지토리 루트에서 체커를 실행하고, 0이 아닌 종료 코드는 병합 차단(merge block)으로 간주하십시오. 0 종료는 스캔된 문자열이 레지스터와 일치한다는 의미일 뿐이며, 클레임이 사실이라는 것을 의미하지 않습니다. 링크 확인, 예시 실행, 법률 검토는 이 스크립트가 다루는 것으로 가장하는 별도의 게이트로 남아 있습니다.

mkdir -p tools docs
python3 tools/doc_ownership_check.py docs/register.json docs/setup.md

실행되지 않은 기대치(unexecuted expectation)는 초안 잔여물에 인간 소유 라인 외부에 'quota'라는 단어가 포함되어 있을 때 0이 아닌 종료를 의미합니다. 스탬프가 찍힌 라인만 반복하고 다른 곳에서 금지된 목록을 피하는 깨끗한 초안은 통과 라인을 출력할 것으로 예상됩니다. 해당 기대치들은 이 문서에 대해 실행되지 않았으므로, 팀은 게이트를 신뢰하기 전에 픽스처(fixture)에서 이를 실행해야 합니다.

## 무료 초안 작성 패스가 적합한 경우

공개: 본 문서는 MonkeyCode의 제품 아웃리치(product outreach)의 일환으로 준비되었습니다. MonkeyCode는 이 방법을 오직 두 개의 운영자 제공 옵션이 다루도록 의도된 초안 작업 공간으로서만 사용합니다. 무료 모델 접근 옵션과 무료 서버 옵션은 운영자가 이 워크플로우를 위해 제공한 두 가지 가용성 주장입니다. 어느 쪽 옵션도 쿼터(quota), 하드웨어 프로필, 기간 또는 소유권 스탬프 건너뛰기 권한이 아닙니다.

무료 모델만으로도 초안 작성 단계는 충분합니다. 왜냐하면 이 단계에서는 제품 사실을 생성하는 것이 금지되어 있기 때문입니다. 검토자가 레지스터(register), 초안(draft), 그리고 검사기(checker)를 담고 있는 하나의 작업 공간이 필요할 때 무료 서버가 충분합니다. 독자들은 설정 페이지가 반복하기 전에 현재 프로젝트 문서에서 두 가지 옵션 모두를 확인해야 합니다. 만약 리포지토리가 라이선싱에 대한 진실의 원천이라면, 기억해서 라이선스 조건을 다시 서술하는 대신 그 리포지토리를 인용하십시오.

## 제한 사항 (Limitations)

이 검사기는 문자열 게이트(string gate)이기 때문에, 금지된 단어들을 제거하더라도 우회적인 표현은 여전히 통과할 수 있습니다. 이 검사기는 예시를 실행하거나, 링크를 검증하거나, 인용된 페이지가 어제 레지스터와 여전히 일치하는지 증명하지 않습니다. 팀들은 통과한 실행을 준수 인증(compliance certification), 보안 검토(security review) 또는 독서의 대체재로 취급해서는 안 됩니다. 가용성 주장에 대해 인간 소유자를 명시할 수 없는 저자는 그 주장을 작성하여 우회하는 대신 생략해야 합니다.

## 이 접근 방식을 건너뛰어야 하는 경우 (Who should skip this approach)

페이지가 외부인이 의존할 만한 제품 사실을 언급하지 않는 개인 로그일 경우에는 워크플로우를 건너뛰십시오. 이런 경우 레지스터는 지원되지 않는 공개 진술의 위험을 줄이지 못하면서 형식적인 절차만 추가합니다. 법률 또는 보안 사본이 자문 변호사(counsel)로부터 와야 하는 경우에도 건너뛰어야 합니다. 왜냐하면 문서화 경로는 잘못된 소유자이기 때문입니다. 또한, 유일한 목표가 도구 언급을 최대화하는 것일 때도 건너뛰십시오. 왜냐하면 페이지는 그러한 언급 없이도 유용하게 유지되어야 하기 때문입니다.

소유권 분할이 실제로 제약 사항이라면, 레지스터를 확장하기 전에 하나의 설정 페이지에서 여섯 단계를 연습하십시오. 제품 언급은 모든 모델 문장이 제거된 후에도 인간이 여전히 방어할 수 있는 단일 문장으로 제한해야 합니다. 그 남아있는 문장은 할당량(quota), 기간 또는 하드웨어 주장을 고정하는 대신 독자들을 현재 프로젝트 문서로 안내해야 합니다.