Disciplina de citación

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

De un vistazo

Esta es la página a la que remite el resto de Insider_ cuando dice «nivel de evidencia». Explica por qué esta documentación parafrasea los estándares en lugar de citarlos textualmente, cómo se vincula una afirmación a un identificador de referencia que puede volver a verificarse y qué promete exactamente cada uno de los ocho niveles de evidencia y qué no promete.

Está escrita para un ingeniero sénior que, antes de confiar en una afirmación, quiere conocer las reglas bajo las que se formuló esa afirmación, y hace bien en quererlo.

Por qué esto importa

Todas las demás páginas de Insider_ hacen afirmaciones y las marcan con un nivel de evidencia. Ese sello solo tiene valor si el sistema que lo respalda es explícito. Si «respaldado por un estándar» pudiera significar cualquier cosa, desde «leí la especificación con atención» hasta «recuerdo más o menos lo que decía», la insignia quedaría en mera decoración.

También hay una restricción más exigente. Muchos de los documentos con los que trabaja NextPDF —las especificaciones ISO, ETSI y similares— tienen licencia. No está permitido reproducir su texto, sea cual sea su extensión. Así que la disciplina debe resolver dos problemas a la vez: hacer que una afirmación sea verificable frente a su fuente, sin reproducir esa fuente. La respuesta a ambos es el mismo mecanismo, y esta página es su especificación.

La versión breve

Insider_ parafrasea los estándares y nunca cita textualmente los estándares con licencia. Una afirmación cita el estándar, la cláusula y un identificador de referencia; no reproduce las palabras del estándar.
La paráfrasis no es un atajo; es una prueba de comprensión. Reformular un requisito con la voz propia de NextPDF obliga a entenderlo y mantiene la terminología coherente con el glosario Spec: ISO/IEC/IEEE 26514, §8 .
Toda afirmación respaldada por un estándar lleva un reference_id de 64 caracteres en el frontmatter citations de la página, de modo que el siguiente revisor pueda volver a recuperar el fragmento de origen exacto y confirmar la paráfrasis.
La insignia declara un nivel de evidencia —uno de ocho tipos— que indica el tipo de prueba, de modo que una afirmación excesiva salte a la vista de un vistazo.
Cuando no se puede recuperar la fuente, la afirmación no se falsea. Se conserva, se marca como no resuelta frente a un registro de re-anclaje, y la página permanece sin publicar: un protocolo documentado, no una improvisación.

Cómo lo aborda NextPDF

Paráfrasis, no cita textual

La regla más estricta de la jerarquía de estilo de NextPDF prevalece sobre cualquier guía anterior: nada de texto literal de un organismo de normalización con licencia, por breve que sea el extracto. En su lugar, la página cita el estándar y la cláusula, parafrasea el requisito con su propia voz y registra el identificador de referencia de origen.

Esto suele plantearse como una restricción de licencia, y lo es. Pero el enfoque más útil es editorial. Una cita textual solo demuestra que se sabe copiar. Una paráfrasis fiel demuestra que la cláusula se entendió lo bastante bien como para reformularla sin cambiar su significado. Y permite que la frase se mantenga en el vocabulario coherente de NextPDF en lugar de cambiar de registro a mitad de página, tal como exige el modelo de calidad de la documentación Spec: ISO/IEC/IEEE 26514, §8 . El lenguaje claro se juzga por si un lector puede encontrar, entender y usar el contenido, no por si la prosa refleja la fuente Spec: ISO 24495-1, §Introduction ; la paráfrasis sirve a ese fin; la cita textual, no.

Una afirmación se vincula a un identificador de referencia, no a un recuerdo

El mecanismo que hace verificable una paráfrasis es el identificador de referencia. Toda afirmación respaldada por un estándar lleva un reference_id completo de 64 caracteres en el frontmatter citations de la página, que identifica el fragmento de origen exacto a partir del cual se hizo la paráfrasis. Un revisor no tiene que confiar en el recuerdo de quien escribe; recupera de nuevo ese fragmento y lo compara. El identificador de referencia es el enlace entre una fuente que no se puede citar y una afirmación verificable. Señala dónde está la prueba sin incorporar el texto de la prueba.

El nivel de evidencia indica qué tipo de prueba es esta

Una cita responde a «de dónde». El nivel de evidencia responde a «de qué tipo». Toda página de Insider_ declara uno, que se muestra en la fila de insignias, extraído de un conjunto fijo de ocho. La escala de confianza sitúa el código y las pruebas por encima del tiempo de ejecución, el tiempo de ejecución por encima de los metadatos y los metadatos por encima de la prosa; una página editorial no pretende estar respaldada por código.

Nivel de evidencia	Qué promete	Qué no promete
Evidence: Code-backed	La afirmación se verifica frente al código fuente del motor o un ejemplo ejecutable	Que un estándar lo exija
Evidence: Standard-backed	La afirmación se ancla a una cláusula citada y parafraseada con un identificador de referencia	Que el código lo implemente actualmente sin excepción
Evidence: Test-backed	Una prueba del conjunto mantiene el comportamiento establecido	Una cifra de rendimiento
Evidence: Benchmark-backed	Una medición con un método declarado respalda la cifra	La misma cifra en el hardware local
Evidence: Artifact-backed	Un artefacto producido (una salida de compilación, un informe) lo demuestra	Un mandato de un estándar
Evidence: Design principle	Una decisión de diseño deliberada y argumentada	Una medición empírica
Evidence: Editorial	Una explicación razonada que organiza otras evidencias	Una nueva garantía de comportamiento propia
Evidence: Mixed evidence	La página combina bases y especifica cuál corresponde a cada afirmación	Una única base limpia

Esta página es Evidence: Editorial : no afirma ningún comportamiento propio del motor. Explica el sistema en el que se apoyan las insignias de las demás páginas. Ese es el nivel honesto para ella, y decirlo es la disciplina aplicada a sí misma.

Cuando no se puede recuperar la fuente

La recuperación no siempre está disponible. La integridad de la disciplina se ve en lo que ocurre entonces. Una cola, un límite de tasa o una pausa por presupuesto normales no son una interrupción del servicio. La persona que escribe espera. Una interrupción genuina activa un mecanismo de respaldo documentado: la afirmación se conserva, se vincula a la evidencia del propio repositorio y a las referencias de estándares que el código mismo declara, se marca explícitamente como no resuelta frente a un registro permanente de re-anclaje, y la página permanece sin publicar hasta que el identificador de referencia quede realmente anclado.

Las maniobras prohibidas están enumeradas y son verificables: un identificador de referencia fabricado, un valor rellenado o con prefijo para parecer real, una cláusula escrita de memoria y disfrazada de cita recuperada, o eliminar en silencio la afirmación para esquivar la cita. Una interrupción correctamente marcada en un borrador es deuda con una entrada en el registro, no un defecto. Una comprobación offline y determinista aplica exactamente esa distinción.

Qué dice la evidencia

Esta página es Evidence: Editorial , de modo que su base propia es la gobernanza de la documentación de este repositorio más los estándares que justifican la disciplina. Las afirmaciones presentes aquí son verificables de dos formas: leyendo las reglas del propio repositorio y volviendo a recuperar las cláusulas citadas.

Afirmación	Base	Anclaje
La paráfrasis obliga a la comprensión	Estándar	Lenguaje claro evaluado por el uso del lector, no por reflejar la fuente Spec: ISO 24495-1, §Introduction
La terminología se mantiene coherente	Estándar	Cada término se usa de forma coherente en todo el documento Spec: ISO/IEC/IEEE 26514, §8
La revisión forma parte del proceso	Estándar	Pruebas de verificación y validación dentro del desarrollo Spec: ISO/IEC/IEEE 26513, §Foreword
El nivel de evidencia es reconocible primero	Estándar	Reconocimiento antes que recuerdo Spec: ISO 9241-110, §5.6.2
Sin texto literal con licencia; anclado por referencia	En el repositorio	`docs/style/nextpdf-overrides.md` §5; `composer docs:jaccard-fingerprint`
El respaldo ante interrupciones es un protocolo real	En el repositorio	La gobernanza normativa del respaldo de RAG + la verificación offline `docs:rag-fallback-check`

Ejemplo práctico

La disciplina es concreta: es la estructura del frontmatter citations de una página. Cada entrada es el comprobante de una afirmación.

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"

No hay campo quote, por diseño. El topic es la reformulación propia de NextPDF. El reference_id es cómo un revisor vuelve a la fuente exacta para comprobar esa reformulación. El comprobante lleva el puntero a la prueba, no las palabras de la prueba.

Concepto erróneo habitual

La trampa está en leer «parafrasea, no cites textualmente» como una evasiva: una forma de sonar con autoridad sin comprometerse. Es justo lo contrario. Una cita textual no compromete a quien escribe; toma prestadas las palabras de otro. Una paráfrasis citada compromete a quien escribe con una reformulación que un revisor puede refutar frente a la fuente. La disciplina hace que las afirmaciones sean más responsables, no menos.

La segunda trampa es tratar «editorial» como un grado más débil de «respaldado por un estándar». No es un grado en absoluto; es un tipo distinto. Una página editorial como esta organiza y explica otras evidencias. Está etiquetada correctamente. Y la etiqueta es lo que importa: el sistema funciona porque una página indica qué tipo de prueba está ofreciendo antes de decidir cuánto peso darle.

Límites y fronteras

Esta página especifica la disciplina de citación; no es la hoja de estilo, ni la gobernanza del respaldo, ni el código de la verificación. Los artefactos autoritativos están en el repositorio (docs/style/nextpdf-overrides.md §5, la gobernanza normativa del respaldo de RAG, los scripts composer.jsondocs:*) y prevalecen sobre cualquier resumen incluido aquí si divergen. No afirma ningún comportamiento del motor.

La disciplina vincula la afirmación, no la conclusión del lector. Una paráfrasis citada con fidelidad indica qué exige una cláusula. Determinar si la interpretación de NextPDF es la que necesita una obligación concreta sigue siendo decisión del lector, por lo que las páginas de comportamiento también llevan evidencia respaldada por código o por pruebas, no solo respaldada por un estándar. La aplicación es parcial y se declara con honestidad: la verificación offline del respaldo está activa, y los verificadores de cita textual y de citación en vivo están conectados; sus ejecutores exhaustivos siguen en desarrollo y se declaran en progreso, no terminados.

Documentos relacionados

La documentación como producto — la disciplina de calidad más amplia de la que forma parte este sistema de citación.
El panorama de los estándares — los estándares a los que remiten estas citas y cómo una cláusula se convierte en comportamiento documentado.
La pirámide de pruebas de NextPDF — qué significa la evidencia respaldada por pruebas cuando una página reclama ese nivel en lugar de este.

Glosario

Disciplina de citación — el conjunto de reglas que rige cómo se vincula una afirmación de Insider_ a su fuente: parafrasear, citar la cláusula, anclar un identificador de referencia y nunca citar textualmente un estándar con licencia.
Paráfrasis — la reformulación de un requisito con la voz propia de NextPDF, coherente con el glosario; la prueba de comprensión que sustituye a la cita textual.
reference_id — el puntero de integridad completo de 64 caracteres del fragmento de origen exacto a partir del cual se hizo una paráfrasis, registrado para que un revisor pueda volver a recuperarlo y verificarlo.
Nivel de evidencia — el tipo declarado de prueba que respalda las afirmaciones de una página, uno de ocho (respaldado por código, por estándar, por pruebas, por benchmark, por artefacto, principio de diseño, editorial, mixto), que se muestra en la fila de insignias.
Cita no resuelta — una afirmación cuyo identificador de referencia no se pudo anclar debido a una interrupción genuina de la recuperación; se conserva, se marca frente a un registro de re-anclaje y se mantiene fuera de la publicación en lugar de falsearse.