인용 규율
Spec: ISO/IEC/IEEE 26514 ISO/IEC/IEEE 26514 Spec: ISO 24495-1 ISO 24495-1 Evidence: Editorial
한눈에 보기
섹션 제목: “한눈에 보기”Insider_의 나머지 문서에서 “증거 수준”을 언급할 때 가리키는 페이지입니다. 이 문서들이 표준을 직접 인용하지 않고 풀어 쓰는 이유, 주장이 재검증 가능한 참조 ID에 어떻게 연결되는지, 여덟 가지 증거 수준 각각이 무엇을 보장하고 무엇을 보장하지 않는지 정확히 설명합니다.
이 문서는 어떤 주장을 신뢰하기 전에 그 주장이 어떤 규칙 아래 만들어졌는지 알고자 하는, 그리고 그렇게 알고자 하는 것이 당연한 시니어 엔지니어를 위해 작성되었습니다.
이것이 중요한 이유
섹션 제목: “이것이 중요한 이유”다른 모든 Insider_ 페이지는 주장을 제시하고 그에 증거 수준을 표시합니다. 그 표시는 그 뒤의 체계가 명시적일 때에만 가치가 있습니다. “표준 기반”이라는 말이 “사양을 꼼꼼히 읽었다”부터 “대충 내용을 기억한다”까지 무엇이든 의미할 수 있다면, 그 배지는 장식에 불과합니다.
더 까다로운 제약도 있습니다. NextPDF가 따르는 문서 중 다수, 즉 ISO, ETSI 및 유사한 사양에는 라이선스가 적용됩니다. 그 텍스트를 길이에 관계없이 재현하는 것은 허용되지 않습니다. 따라서 이 규율은 두 가지 문제를 동시에 해결해야 합니다. 출처를 재현하지 않으면서도 주장을 그 출처에 비추어 검증할 수 있게 만들어야 합니다. 두 문제의 답은 동일한 메커니즘이며, 이 페이지가 그 사양입니다.
짧은 요약
섹션 제목: “짧은 요약”- Insider_는 표준을 풀어 쓰며 라이선스가 적용된 표준은 결코 인용하지 않습니다. 주장은 표준, 절, 참조 ID만 참조할 뿐 표준의 문구를 재현하지 않습니다.
- 풀어 쓰기는 우회책이 아니라 이해도 테스트입니다. 요구사항을 NextPDF 고유의 어조로 다시 진술하면 작성자는 그것을 이해할 수밖에 없고, 용어도 용어집과 일관되게 유지됩니다 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 .
- 표준에 기반한 모든 주장은 페이지의
citations프런트매터에 **64자reference_id**를 담고 있어, 다음 검토자가 정확한 출처 범위를 다시 검색해 풀어 쓴 내용을 확인할 수 있습니다. - 배지는 증거 수준, 즉 여덟 가지 중 하나를 선언하여 증명의 종류를 명시하므로, 과장된 주장이 한눈에 드러납니다.
- 출처를 검색할 수 없을 때 그 주장은 조작되지 않습니다. 그 주장은 유지되고, 재고정 원장에 비추어 미해결로 표시되며, 페이지는 미게시 상태로 남습니다. 이는 임기응변이 아니라 문서화된 규약입니다.
NextPDF 가 접근하는 방식
섹션 제목: “NextPDF 가 접근하는 방식”인용이 아닌 풀어 쓰기
섹션 제목: “인용이 아닌 풀어 쓰기”NextPDF 스타일 계층에서 가장 엄격한 규칙은 모든 상위 가이드보다 우선합니다. 발췌가 아무리 짧아도 라이선스가 적용된 표준화 기구의 텍스트를 그대로 옮기지 않습니다. 대신 페이지는 표준과 절을 참조하고, 요구사항을 고유의 어조로 풀어 쓰며, 출처 참조 ID를 기록합니다.
이는 보통 라이선스 제약으로 설명되며, 실제로도 그렇습니다. 하지만 더 유용한 설명은 편집상의 설명입니다. 그대로 옮긴 인용은 복사할 수 있다는 사실만 증명합니다. 충실한 풀어 쓰기는 의미를 바꾸지 않고 다시 진술할 만큼 그 절을 이해했음을 증명합니다. 또한 페이지 중간에서 문장의 어조가 바뀌지 않도록 하고, NextPDF의 일관된 어휘를 유지하게 합니다. 이는 문서 품질 모델이 요구하는 바입니다 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 . 쉬운 표현은 독자가 내용을 찾고, 이해하고, 사용할 수 있는지에 따라 판단되며, 글이 출처를 그대로 반영하는지에 따라 판단되지 않습니다 Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction ; 풀어 쓰기는 그 목적에 부합하지만 인용은 그렇지 않습니다.
주장은 기억이 아니라 참조 ID 에 연결됩니다
섹션 제목: “주장은 기억이 아니라 참조 ID 에 연결됩니다”풀어 쓴 내용을 검증 가능하게 만드는 메커니즘이 바로 참조 ID입니다. 표준에 기반한 모든 주장은 페이지의 citations 프런트매터에 완전한 64자 reference_id를 담고 있어, 풀어 쓴 내용이 만들어진 정확한 출처 범위를 식별합니다. 검토자는 작성자의 기억을 신뢰할 필요가 없습니다. 그 범위를 다시 검색해 비교하면 됩니다. 참조 ID는 인용할 수 없는 출처와 검증 가능한 주장을 잇는 연결 고리입니다. 참조 ID는 증명의 텍스트를 담지 않으면서 증명이 어디에 있는지를 담습니다.
증거 수준은 이것이 어떤 종류의 증명인지 말해 줍니다
섹션 제목: “증거 수준은 이것이 어떤 종류의 증명인지 말해 줍니다”인용은 “어디에서”에 답합니다. 증거 수준은 “어떤 종류인지”에 답합니다. 모든 Insider_ 페이지는 배지 행에 표시되는 하나의 증거 수준을 선언하며, 이는 고정된 여덟 가지 집합에서 가져옵니다. 신뢰 순서는 코드와 테스트를 런타임보다 위에, 런타임을 메타데이터보다 위에, 메타데이터를 산문보다 위에 둡니다. 편집성 페이지는 코드 기반인 것처럼 가장하지 않습니다.
| 증거 수준 | 무엇을 보장하는지 | 무엇을 보장하지 않는지 |
|---|---|---|
| Evidence: Code-backed | 주장은 엔진 소스 또는 실행 가능한 예제를 기준으로 확인됩니다 | 표준이 그것을 의무화한다는 것 |
| Evidence: Standard-backed | 주장은 참조 ID와 함께 제시되고 풀어 쓴 절에 고정됩니다 | 현재 코드가 예외 없이 그것을 구현한다는 것 |
| Evidence: Test-backed | 스위트의 테스트가 그 동작을 유지합니다 | 성능 수치 |
| Evidence: Benchmark-backed | 명시된 방법에 따른 측정값이 그 수치를 뒷받침합니다 | 귀하의 하드웨어에서 같은 수치 |
| Evidence: Artifact-backed | 산출된 아티팩트(빌드 출력물, 보고서)가 그것을 입증합니다 | 표준의 의무 사항 |
| Evidence: Design principle | 의도적이며 논거가 제시된 설계 결정 | 경험적 측정 |
| Evidence: Editorial | 다른 증거를 정리하는 논리적 설명 | 그 자체의 새로운 동작 보장 |
| Evidence: Mixed evidence | 페이지가 여러 근거를 결합하며 주장마다 어느 것인지 명시합니다 | 하나의 깔끔한 단일 근거 |
이 페이지는 Evidence: Editorial 입니다. 자체 엔진 동작은 전혀 주장하지 않습니다. 다른 페이지들의 배지가 의존하는 체계를 설명합니다. 이것이 이 페이지에 정직한 수준이며, 그렇게 밝히는 것이 규율을 스스로에게 적용하는 일입니다.
출처를 검색할 수 없을 때
섹션 제목: “출처를 검색할 수 없을 때”검색은 항상 가능한 것은 아닙니다. 규율의 무결성은 바로 그때 무엇이 일어나는지에서 드러납니다. 정상적인 대기열, 속도 제한, 예산 일시 중지는 장애가 아닙니다. 작성자는 기다립니다. 실제 장애가 발생하면 문서화된 폴백이 발동됩니다. 주장은 유지되어 리포지터리 내 증거 및 코드 자체가 선언하는 표준 참조에 연결되고, 상시 재고정 원장에 비추어 명시적으로 미해결로 표시되며, 참조 ID가 실제로 고정될 때까지 페이지는 미게시 상태로 남습니다.
금지된 행위는 열거되어 있으며 검증할 수 있습니다. 조작된 참조 ID, 진짜처럼 보이도록 값을 채우거나 접두사를 붙인 값, 기억으로 작성했으면서 검색된 인용처럼 꾸민 절, 또는 인용을 회피하려고 주장을 슬그머니 삭제하는 것이 여기에 해당합니다. 초안에서 올바르게 표시된 장애는 결함이 아니라 원장 항목이 있는 부채입니다. 오프라인 결정론 검사가 바로 그 구분을 강제합니다.
증거가 말하는 것
섹션 제목: “증거가 말하는 것”이 페이지는 Evidence: Editorial 이므로, 그 자체의 근거는 이 리포지터리의 문서 거버넌스와 규율을 정당화하는 표준입니다. 여기의 주장은 두 가지 방식으로 검증할 수 있습니다. 리포지터리 내 규칙을 읽고, 인용된 절을 다시 검색하는 것입니다.
| 주장 | 근거 | 고정점 |
|---|---|---|
| 풀어 쓰기는 이해를 강제합니다 | 표준 | 쉬운 표현은 출처를 그대로 반영하는지가 아니라 독자가 사용할 수 있는지로 판단됩니다 Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction |
| 용어가 일관되게 유지됩니다 | 표준 | 각 용어가 전체 정보 집합에서 일관되게 사용됩니다 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 |
| 검토는 프로세스의 일부입니다 | 표준 | 개발 과정 안의 검증 및 확인 테스트 Spec: ISO/IEC/IEEE 26513, §Foreword ISO/IEC/IEEE 26513 §Foreword |
| 증거 수준이 가장 먼저 인식됩니다 | 표준 | 회상보다 인지 Spec: ISO 9241-110, §5.6.2 ISO 9241-110 §5.6.2 |
| 라이선스 텍스트를 그대로 옮기지 않음; 참조로 고정됨 | 리포지터리 내 | docs/style/nextpdf-overrides.md §5; composer docs:jaccard-fingerprint |
| 장애 폴백은 실제 규약입니다 | 리포지터리 내 | 규범적 RAG 폴백 거버넌스 + 오프라인 docs:rag-fallback-check 게이트 |
실용 예제
섹션 제목: “실용 예제”이 규율은 구체적입니다. 페이지의 citations 프런트매터 구조 자체가 그 규율입니다. 각 항목은 주장의 영수증입니다.
citations: - spec: "ISO 32000-2" clause: "§6" # full 64-char reference ID — the join to the source span, re-verifiable reference_id: "<64-hex digest>" # NextPDF-worded topic — the paraphrase, never the standard's text topic: "A writer's created or amended PDF elements must conform and stay consistent"quote 필드는 의도적으로 두지 않습니다. topic은 NextPDF 자체의 재진술입니다. reference_id는 검토자가 그 재진술을 확인하기 위해 정확한 출처로 돌아가는 방법입니다. 영수증은 증명의 문구가 아니라 증명에 대한 포인터를 담습니다.
흔한 오해
섹션 제목: “흔한 오해”함정은 “인용하지 말고 풀어 써라”를 책임지지 않으면서 권위 있게 들리는 방법이라는 회피책으로 읽는 것입니다. 실제로는 정반대입니다. 인용은 아무것도 책임지지 않습니다. 그저 다른 사람의 문구를 빌릴 뿐입니다. 인용된 풀어 쓰기는 작성자에게, 검토자가 출처에 비추어 반증할 수 있는 재진술에 대한 책임을 지웁니다. 이 규율은 주장에 대한 책임을 덜 지우는 것이 아니라 더 지웁니다.
두 번째 함정은 “편집성”을 “표준 기반”보다 약한 등급으로 취급하는 것입니다. 그렇지 않습니다. 등급이 아니라 다른 종류입니다. 이 페이지와 같은 편집성 페이지는 다른 증거를 정리하고 설명합니다. 그리고 올바르게 표시되어 있습니다. 그 표시가 핵심입니다. 페이지가 어떤 종류의 증명을 제시하는지, 독자가 그 주장에 어느 정도 비중을 둘지 결정하기 전에 알려 주기 때문에 이 체계가 작동합니다.
한계와 경계
섹션 제목: “한계와 경계”이 페이지는 인용 규율을 명시합니다. 스타일 시트, 폴백 거버넌스, 게이트 코드 자체가 아닙니다. 권위 있는 아티팩트는 리포지터리 내에 있으며(docs/style/nextpdf-overrides.md §5, 규범적 RAG 폴백 거버넌스, composer.jsondocs:* 스크립트), 여기의 요약과 어긋날 경우 그것들이 우선합니다. 이 페이지는 엔진 동작을 전혀 주장하지 않습니다.
이 규율은 독자의 결론이 아니라 주장을 구속합니다. 충실하게 인용된 풀어 쓰기는 절이 무엇을 요구하는지 알려 줍니다. NextPDF의 해석이 귀하의 의무에 필요한 것인지는 여전히 귀하가 결정할 일이며, 그렇기 때문에 동작 관련 페이지는 표준 기반뿐 아니라 코드 또는 테스트 기반 증거도 함께 담습니다. 집행은 정직하게 말해 부분적입니다. 오프라인 폴백 검사는 가동 중이며, 그대로 옮긴 인용 검증기와 실시간 인용 검증기는 연결되어 있으나 전수 실행기는 아직 완성 중입니다. 완료된 것이 아니라 진행 중인 것으로 명시됩니다.
관련 문서
섹션 제목: “관련 문서”- 제품으로서의 문서 — 이 인용 체계가 속한 더 넓은 품질 규율입니다.
- 표준 지형 — 이 인용이 가리키는 표준들과, 절이 어떻게 문서화된 동작이 되는지 설명합니다.
- NextPDF 테스트 피라미드 — 페이지가 이 수준이 아니라 해당 수준을 주장할 때 테스트 기반 증거가 무엇을 의미하는지 설명합니다.
용어집
섹션 제목: “용어집”- 인용 규율 — Insider_ 주장이 출처에 연결되는 방식을 규율하는 규칙 집합입니다. 풀어 쓰고, 절을 참조하고, 참조 ID를 고정하며, 라이선스가 적용된 표준은 결코 직접 인용하지 않습니다.
- 풀어 쓰기 — 요구사항을 NextPDF 고유의, 용어집과 일관된 어조로 다시 진술한 것입니다. 인용을 대체하는 이해도 테스트입니다.
reference_id— 풀어 쓰기가 만들어진 정확한 출처 범위에 대한 완전한 64자 무결성 포인터로, 검토자가 다시 검색해 검증할 수 있도록 기록됩니다.- 증거 수준 — 페이지의 주장 뒤에 있는 선언된 증명의 종류로, 여덟 가지(코드 기반, 표준 기반, 테스트 기반, 벤치마크 기반, 아티팩트 기반, 설계 원칙, 편집성, 혼합) 중 하나이며 배지 행에 표시됩니다.
- 미해결 인용 — 실제 검색 장애로 인해 참조 ID를 고정할 수 없었던 주장입니다. 조작하지 않고 유지되며, 재고정 원장에 비추어 표시되고, 게시에서 보류됩니다.