Método editorial y plantilla de lectura técnica

Campos obligatorios de una publicación

Cada campo se completa con información revisada o no se completa. No se aproxima, no se infiere y no se sustituye por una redacción que suene equivalente.

Campos obligatorios de una publicación técnica

Tipo de pieza

Nota de desarrollo, nota de método, demostración acotada, caso de evaluación, página de capacidad o método, o referencia técnica. Es una clasificación editorial, no un nivel de validación.

Pilar principal

Uno de los cuatro pilares del archivo. Los pilares secundarios se declaran sólo si son materiales para la pregunta o el método.

Estado de evidencia

Un único valor principal: conceptual, revisión documental, datos sintéticos, simulación, banco de prueba, medición de campo, evidencia mixta o pendiente de validación.

Artefacto y versión

Identificador y versión del artefacto, modelo, procedimiento o herramienta examinados. Si la versión no está documentada, se declara como no documentada.

Responsable técnico

Rol o identidad publicable de quien responde por el contenido y de quien lo revisa. No se publican nombres, cargos ni credenciales sin confirmación y autorización.

Fecha de revisión

Fecha ISO 8601 de la revisión técnica, junto con la de publicación y, si aplica, la de actualización. Sin fechas conocidas la pieza no pasa a publicada.

Pregunta de ingeniería

La situación, variable, decisión o límite que se examina. No atribuye un problema, un impacto o una necesidad a una instalación o a un tercero no documentado.

Método y evidencia

Supuestos, procedimiento, entradas, salidas, configuración y revisión humana aplicable, junto con la clase de evidencia que sostiene cada afirmación.

Límites

Lista concreta de inferencias que la pieza no permite, datos faltantes, rangos no cubiertos, incertidumbre conocida y validaciones pendientes.

Figura: procedencia, texto alternativo y epígrafe

Cada figura informativa declara su origen o autorización, un texto alternativo que transmite la información que se perdería sin la imagen, y un epígrafe con condiciones, unidades y base de evidencia.

Fuentes

Cada fuente indica su tipo (primaria, de método, de tercero, normativa o artefacto), su referencia, su versión o fecha y su estado de revisión. Una URL sin procedencia no sostiene una afirmación.

Siguiente paso verificable

La validación, medición, versión o autorización pendiente. No promete fecha, integración, disponibilidad ni desempeño.

Si un campo no puede sustentarse con una fuente revisada, la pieza permanece interna. No se publica con el campo vacío, aproximado ni completado por inferencia, y no se simula el dato ausente con un marcador de posición visible para el lector.

Estados de evidencia

El estado de evidencia es un valor controlado, visible en la ficha y en el cuerpo de la pieza. Una simulación no se denomina ensayo y un dato sintético no se denomina medición.

• Conceptual: describe una idea, un modelo mental o un esquema, sin resultado propio.
• Revisión documental: se apoya en fuentes externas identificadas, no en observaciones propias.
• Datos sintéticos: datos construidos para ilustrar un caso, con su receta y supuestos declarados.
• Simulación: salidas de un modelo, con herramienta, versión, entradas y condiciones de contorno.
• Banco de prueba: medición en banco, con montaje, instrumento, procedimiento y unidades.
• Medición de campo: observación en un entorno operativo, con periodo, contexto y método de adquisición.
• Evidencia mixta: la pieza enumera qué parte corresponde a cada categoría y en qué orden se usó.
• Pendiente de validación: no puede publicarse como resultado; permanece como registro interno.

Contrato de figuras

Ninguna figura informativa se publica sin procedencia, texto alternativo y epígrafe. Una figura no puede sostener una afirmación que el texto, el método y las fuentes no permitan.

• Procedencia: origen, autorización o licencia, y la base de evidencia que representa.
• Texto alternativo: la información que se perdería sin la imagen, no la frase «gráfico de».
• Epígrafe: qué muestra, bajo qué condiciones, en qué unidades y con qué límite principal.
• Lectura permitida: lo que puede observarse y la inferencia que no corresponde hacer.

Dónde se aplica