Disciplina de citación

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

De un vistazo

Esta es la página a la que remite el resto de Insider_ cuando explica cómo cita un estándar. Explica por qué esta documentación parafrasea las especificaciones en lugar de citarlas textualmente, cómo una afirmación nombra el estándar y la cláusula exacta sobre la que se apoya, y qué promete exactamente una citación limpia 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 vinculan a un estándar y una cláusula con nombre. Esa citación solo tiene valor si la disciplina que la respalda es explícita. 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 citación 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 rastreable hasta su fuente, sin reproducir esa fuente. Una citación precisa y una paráfrasis fiel responden a ambos, 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 nombra el estándar y la cláusula exacta; 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 nombra una cláusula o sección concreta, no un documento entero, de modo que el siguiente revisor pueda abrir esa cláusula y confirmar la paráfrasis frente a ella.
Una citación indica el tipo de fuente sobre la que se apoya —una cláusula, el código del motor, una prueba, una medición—, de modo que una afirmación excesiva salte a la vista de un vistazo.
Cuando una afirmación no puede vincularse a una cláusula que quien escribe haya leído realmente, no se falsea. Se conserva, se marca como no resuelta, 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 nombra el estándar y la cláusula y parafrasea el requisito con su propia voz.

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 nombra la cláusula, no solo el documento

El mecanismo que hace verificable una paráfrasis es la precisión. Toda afirmación respaldada por un estándar nombra la cláusula o sección exacta sobre la que se apoya —por ejemplo, ISO 32000-2 §6—, no solo el documento. Un revisor no tiene que confiar en el recuerdo de quien escribe; abre esa cláusula y la compara con la reformulación. La referencia a la cláusula es el enlace entre una fuente que no se puede citar y una afirmación verificable. Señala dónde mirar sin incorporar el texto de la fuente.

Una citación indica qué tipo de fuente es esta

Una citación responde a «de dónde». También debe responder a «de qué tipo». Decir que una afirmación se apoya en una cláusula de un estándar es una promesa distinta de decir que se apoya en el propio código del motor, en una prueba o en una medición. NextPDF mantiene esos tipos diferenciados para que un lector pueda sopesarlos: el código y las pruebas se sitúan por encima del comportamiento en 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 como esta no pretende estar respaldada por código.

Tipo de fuente	Qué promete	Qué no promete
Respaldado por código	La afirmación se verifica frente al código fuente del motor o un ejemplo ejecutable	Que un estándar lo exija
Respaldado por un estándar	La afirmación se ancla a una cláusula citada y parafraseada	Que el código lo implemente actualmente sin excepción
Respaldado por pruebas	Una prueba del conjunto mantiene el comportamiento establecido	Una cifra de rendimiento
Respaldado por benchmark	Una medición con un método declarado respalda la cifra	La misma cifra en el hardware local
Respaldado por artefacto	Un artefacto producido (una salida de compilación, un informe) lo demuestra	Un mandato de un estándar
Principio de diseño	Una decisión de diseño deliberada y argumentada	Una medición empírica
Editorial	Una explicación razonada que organiza otro material	Una nueva garantía de comportamiento propia
Mixto	La página combina bases y especifica cuál corresponde a cada afirmación	Una única base limpia

Esta página es editorial: no afirma ningún comportamiento propio del motor. Explica la disciplina en la que se apoyan las citaciones de las demás páginas. Esa es la base honesta para ella, y decirlo es la disciplina aplicada a sí misma.

Cuando no se puede leer la fuente

El acceso a un estándar no siempre es inmediato: una especificación con licencia puede ser una que quien escribe aún tiene que conseguir, o una cláusula puede necesitar una segunda lectura hasta que su significado quede claro. La integridad de la disciplina se ve en lo que ocurre entonces. Quien escribe no adivina. Una afirmación que todavía no puede vincularse a una cláusula que quien escribe haya leído realmente se conserva, se vincula al material del propio repositorio y a las referencias de estándares que el código mismo declara, se marca explícitamente como no resuelta, y la página permanece sin publicar hasta que la cláusula quede correctamente citada.

Las maniobras prohibidas están enumeradas y son verificables: un número de cláusula inventado para parecer preciso, una citación disfrazada como si se hubiera leído cuando se escribió de memoria, o eliminar en silencio la afirmación para esquivar la citación. Una citación abierta correctamente marcada en un borrador es deuda con una nota, no un defecto. Una comprobación offline y determinista aplica exactamente esa distinción.

Ejemplo práctico

La disciplina es concreta: es la estructura del frontmatter citations de una página. Cada entrada vincula una afirmación a su cláusula.

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"

No hay campo quote, por diseño. El topic es la reformulación propia de NextPDF. El spec y la clause son cómo un revisor vuelve a la fuente exacta para comprobar esa reformulación. La entrada lleva el puntero a la cláusula, no las palabras de la cláusula.

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 cláusula. 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 otro material. Está etiquetada correctamente. Y la etiqueta es lo que importa: el sistema funciona porque una página indica sobre qué tipo de fuente se apoya 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 el código de la verificación. Los artefactos autoritativos están en el repositorio (docs/style/nextpdf-overrides.md §5 y 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 citaciones respaldadas por código o por pruebas, no solo respaldadas por un estándar. La aplicación es parcial y se declara con honestidad: la verificación offline 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 se apoya en esa base en lugar de en esta.

Glosario

Disciplina de citación — el conjunto de reglas que rige cómo se vincula una afirmación de Insider_ a su fuente: parafrasear, nombrar la cláusula exacta 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.
Referencia a la cláusula — la cláusula o sección exacta sobre la que se apoya una paráfrasis, registrada para que un revisor pueda abrirla y verificar la reformulación.
Afirmación respaldada por un estándar — una afirmación anclada a una cláusula citada y parafraseada de un estándar con nombre, a diferencia de una respaldada por el código del motor, una prueba, una medición o un razonamiento editorial.
Cita no resuelta — una afirmación que todavía no puede vincularse a una cláusula que quien escribe haya leído; se conserva, se marca como abierta y se mantiene fuera de la publicación en lugar de falsearse.