인용 규율

Spec: ISO/IEC/IEEE 26514Spec: ISO 24495-1

한눈에 보기

Insider_의 나머지 문서에서 표준을 어떻게 인용하는지 설명할 때 가리키는 페이지입니다. 이 문서들이 표준을 직접 인용하지 않고 풀어 쓰는 이유, 주장이 표준과 그것이 근거로 삼는 정확한 절을 어떻게 명시하는지, 깔끔한 인용이 무엇을 보장하고 무엇을 보장하지 않는지 정확히 설명합니다.

이 문서는 어떤 주장을 신뢰하기 전에 그 주장이 어떤 규칙 아래 만들어졌는지 알고자 하는, 그리고 그렇게 알고자 하는 것이 당연한 시니어 엔지니어를 위해 작성되었습니다.

이것이 중요한 이유

다른 모든 Insider_ 페이지는 주장을 제시하고 그것을 이름이 명시된 표준과 절에 연결합니다. 그 인용은 그 뒤의 규율이 명시적일 때에만 가치가 있습니다. “표준 기반”이라는 말이 “사양을 꼼꼼히 읽었다”부터 “대충 내용을 기억한다”까지 무엇이든 의미할 수 있다면, 그 인용은 장식에 불과합니다.

더 까다로운 제약도 있습니다. NextPDF가 따르는 문서 중 다수, 즉 ISO, ETSI 및 유사한 사양에는 라이선스가 적용됩니다. 그 텍스트를 길이에 관계없이 재현하는 것은 허용되지 않습니다. 따라서 이 규율은 두 가지 문제를 동시에 해결해야 합니다. 출처를 재현하지 않으면서도 주장을 그 출처까지 추적할 수 있게 만들어야 합니다. 두 문제의 답은 정확한 인용과 충실한 풀어 쓰기이며, 이 페이지가 그 사양입니다.

짧은 요약

Insider_는 표준을 풀어 쓰며 라이선스가 적용된 표준은 결코 인용하지 않습니다. 주장은 표준과 정확한 절을 명시할 뿐 표준의 문구를 재현하지 않습니다.
풀어 쓰기는 우회책이 아니라 이해도 테스트입니다. 요구사항을 NextPDF 고유의 어조로 다시 진술하면 작성자는 그것을 이해할 수밖에 없고, 용어도 용어집과 일관되게 유지됩니다 Spec: ISO/IEC/IEEE 26514, §8.
표준에 기반한 모든 주장은 문서 전체가 아니라 특정 절이나 섹션을 명시하여, 다음 검토자가 그 절을 열어 풀어 쓴 내용을 대조해 확인할 수 있게 합니다.
인용은 그것이 근거로 삼는 출처의 종류(절, 엔진 코드, 테스트, 측정)를 명시하므로, 과장된 주장이 한눈에 드러납니다.
주장을 작성자가 실제로 읽은 절에 연결할 수 없을 때 그 주장은 조작되지 않습니다. 그 주장은 유지되고, 미해결로 표시되며, 페이지는 미게시 상태로 남습니다. 이는 임기응변이 아니라 문서화된 규약입니다.

NextPDF 가 접근하는 방식

인용이 아닌 풀어 쓰기

NextPDF 스타일 계층에서 가장 엄격한 규칙은 모든 상위 가이드보다 우선합니다. 발췌가 아무리 짧아도 라이선스가 적용된 표준화 기구의 텍스트를 그대로 옮기지 않습니다. 대신 페이지는 표준과 절을 명시하고, 요구사항을 고유의 어조로 풀어 씁니다.

이는 보통 라이선스 제약으로 설명되며, 실제로도 그렇습니다. 하지만 더 유용한 설명은 편집상의 설명입니다. 그대로 옮긴 인용은 복사할 수 있다는 사실만 증명합니다. 충실한 풀어 쓰기는 의미를 바꾸지 않고 다시 진술할 만큼 그 절을 이해했음을 증명합니다. 또한 페이지 중간에서 문장의 어조가 바뀌지 않도록 하고, NextPDF의 일관된 어휘를 유지하게 합니다. 이는 문서 품질 모델이 요구하는 바입니다 Spec: ISO/IEC/IEEE 26514, §8. 쉬운 표현은 독자가 내용을 찾고, 이해하고, 사용할 수 있는지에 따라 판단되며, 글이 출처를 그대로 반영하는지에 따라 판단되지 않습니다 Spec: ISO 24495-1, §Introduction; 풀어 쓰기는 그 목적에 부합하지만 인용은 그렇지 않습니다.

주장은 문서가 아니라 절을 명시합니다

풀어 쓴 내용을 검증 가능하게 만드는 메커니즘은 바로 정확성입니다. 표준에 기반한 모든 주장은 그것이 근거로 삼는 정확한 절이나 섹션(예: ISO 32000-2 §6)을 명시할 뿐, 문서만 명시하지 않습니다. 검토자는 작성자의 기억을 신뢰할 필요가 없습니다. 그 절을 열어 재진술과 비교하면 됩니다. 절 참조는 인용할 수 없는 출처와 검증 가능한 주장을 잇는 연결 고리입니다. 절 참조는 출처의 텍스트를 담지 않으면서 어디를 보면 되는지를 담습니다.

인용은 이것이 어떤 종류의 출처인지 말해 줍니다

인용은 “어디에서”에 답합니다. 인용은 “어떤 종류인지”에도 답해야 합니다. 어떤 주장이 표준의 절에 근거한다고 말하는 것은, 그것이 엔진 자체의 코드, 테스트, 또는 측정에 근거한다고 말하는 것과는 다른 약속입니다. NextPDF는 독자가 이를 견주어 볼 수 있도록 이 종류들을 구분해 둡니다. 코드와 테스트는 런타임 동작보다 위에, 런타임은 메타데이터보다 위에, 메타데이터는 산문보다 위에 둡니다. 이 페이지와 같은 편집성 페이지는 코드 기반인 것처럼 가장하지 않습니다.

출처의 종류	무엇을 보장하는지	무엇을 보장하지 않는지
코드 기반	주장은 엔진 소스 또는 실행 가능한 예제를 기준으로 확인됩니다	표준이 그것을 의무화한다는 것
표준 기반	주장은 인용되고 풀어 쓴 절에 고정됩니다	현재 코드가 예외 없이 그것을 구현한다는 것
테스트 기반	스위트의 테스트가 그 동작을 유지합니다	성능 수치
벤치마크 기반	명시된 방법에 따른 측정값이 그 수치를 뒷받침합니다	귀하의 하드웨어에서 같은 수치
아티팩트 기반	산출된 아티팩트(빌드 출력물, 보고서)가 그것을 입증합니다	표준의 의무 사항
설계 원칙	의도적이며 논거가 제시된 설계 결정	경험적 측정
편집성	다른 자료를 정리하는 논리적 설명	그 자체의 새로운 동작 보장
혼합	페이지가 여러 근거를 결합하며 주장마다 어느 것인지 명시합니다	하나의 깔끔한 단일 근거

이 페이지는 편집성입니다. 자체 엔진 동작은 전혀 주장하지 않습니다. 다른 페이지들의 인용이 의존하는 규율을 설명합니다. 이것이 이 페이지에 정직한 근거이며, 그렇게 밝히는 것이 규율을 스스로에게 적용하는 일입니다.

출처를 읽을 수 없을 때

표준에 대한 접근이 항상 즉시 가능한 것은 아닙니다. 라이선스가 적용된 사양은 작성자가 아직 입수해야 할 것일 수도 있고, 어떤 절은 그 의미가 분명해질 때까지 두 번째 읽기가 필요할 수도 있습니다. 규율의 무결성은 바로 그때 무엇이 일어나는지에서 드러납니다. 작성자는 추측하지 않습니다. 작성자가 실제로 읽은 절에 아직 연결할 수 없는 주장은 유지되어 리포지터리 내 자료 및 코드 자체가 선언하는 표준 참조에 연결되고, 명시적으로 미해결로 표시되며, 절이 올바르게 인용될 때까지 페이지는 미게시 상태로 남습니다.

금지된 행위는 열거되어 있으며 검증할 수 있습니다. 정확해 보이도록 지어낸 절 번호, 기억으로 작성했으면서 읽은 것처럼 꾸민 인용, 또는 인용을 회피하려고 주장을 슬그머니 삭제하는 것이 여기에 해당합니다. 초안에서 올바르게 표시된 미완 인용은 결함이 아니라 메모가 있는 부채입니다. 오프라인 결정론 검사가 바로 그 구분을 강제합니다.

실용 예제

이 규율은 구체적입니다. 페이지의 citations 프런트매터 구조 자체가 그 규율입니다. 각 항목은 주장을 그 절에 연결합니다.

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # 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 자체의 재진술입니다. spec과 clause는 검토자가 그 재진술을 확인하기 위해 정확한 출처로 돌아가는 방법입니다. 항목은 절의 문구가 아니라 절에 대한 포인터를 담습니다.

흔한 오해

함정은 “인용하지 말고 풀어 써라”를 책임지지 않으면서 권위 있게 들리는 방법이라는 회피책으로 읽는 것입니다. 실제로는 정반대입니다. 인용은 아무것도 책임지지 않습니다. 그저 다른 사람의 문구를 빌릴 뿐입니다. 인용된 풀어 쓰기는 작성자에게, 검토자가 절에 비추어 반증할 수 있는 재진술에 대한 책임을 지웁니다. 이 규율은 주장에 대한 책임을 덜 지우는 것이 아니라 더 지웁니다.

두 번째 함정은 “편집성”을 “표준 기반”보다 약한 등급으로 취급하는 것입니다. 그렇지 않습니다. 등급이 아니라 다른 종류입니다. 이 페이지와 같은 편집성 페이지는 다른 자료를 정리하고 설명합니다. 그리고 올바르게 표시되어 있습니다. 그 표시가 핵심입니다. 페이지가 어떤 종류의 출처에 근거하는지, 독자가 그 주장에 어느 정도 비중을 둘지 결정하기 전에 알려 주기 때문에 이 체계가 작동합니다.

한계와 경계

이 페이지는 인용 규율을 명시합니다. 스타일 시트나 게이트 코드 자체가 아닙니다. 권위 있는 아티팩트는 리포지터리 내에 있으며(docs/style/nextpdf-overrides.md §5, composer.jsondocs:* 스크립트), 여기의 요약과 어긋날 경우 그것들이 우선합니다. 이 페이지는 엔진 동작을 전혀 주장하지 않습니다.

이 규율은 독자의 결론이 아니라 주장을 구속합니다. 충실하게 인용된 풀어 쓰기는 절이 무엇을 요구하는지 알려 줍니다. NextPDF의 해석이 귀하의 의무에 필요한 것인지는 여전히 귀하가 결정할 일이며, 그렇기 때문에 동작 관련 페이지는 표준 기반뿐 아니라 코드 또는 테스트 기반 인용도 함께 담습니다. 집행은 정직하게 말해 부분적입니다. 오프라인 검사는 가동 중이며, 그대로 옮긴 인용 검증기와 실시간 인용 검증기는 연결되어 있으나 전수 실행기는 아직 완성 중입니다. 완료된 것이 아니라 진행 중인 것으로 명시됩니다.

용어집

인용 규율 — Insider_ 주장이 출처에 연결되는 방식을 규율하는 규칙 집합입니다. 풀어 쓰고, 정확한 절을 명시하며, 라이선스가 적용된 표준은 결코 직접 인용하지 않습니다.
풀어 쓰기 — 요구사항을 NextPDF 고유의, 용어집과 일관된 어조로 다시 진술한 것입니다. 인용을 대체하는 이해도 테스트입니다.
절 참조 — 풀어 쓰기가 근거로 삼는 정확한 절이나 섹션으로, 검토자가 그것을 열어 재진술을 검증할 수 있도록 기록됩니다.
표준에 기반한 주장 — 이름이 명시된 표준의 인용되고 풀어 쓴 절에 고정된 주장으로, 엔진 코드, 테스트, 측정, 또는 편집상의 논증에 근거한 주장과 구별됩니다.
미해결 인용 — 작성자가 읽은 절에 아직 연결할 수 없는 주장입니다. 조작하지 않고 유지되며, 미완으로 표시되고, 게시에서 보류됩니다.