Dos informes para dos lectores

El mismo trabajo se cuenta dos veces porque lo leen personas con tareas distintas. El informe técnico es para quien corrige: cada hallazgo con su evidencia reproducible, su causa, su severidad con el cálculo a la vista y su remediación. El resumen ejecutivo es para quien decide: una conclusión, qué hay que decidir y para cuándo, y lo que más pesa en lenguaje de negocio.

No son el mismo texto a distinta escala. Un resumen que copia las fichas técnicas con menos páginas no sirve a ninguno de los dos.

La primera sección del informe técnico repite la carta de alcance tal cual: qué app, qué versión, qué API, qué cuentas y en qué ventana. Es lo que fija de qué responde el informe y de qué no. Si el informe nombra otra versión, el cliente puede leer que se probó algo que nunca se probó, o que se probó algo que no autorizó.

Antes de entregar, se contrasta cada dato del borrador con la carta. Abre encargo/carta-de-alcance.txt y informe/borrador-resumen-ejecutivo.txt y busca lo que no cuadra entre los dos.

El resumen ejecutivo tiene un tope porque quien decide lo lee entre otras cosas. Si el borrador se pasa, no se le pide al lector que se esfuerce: se recorta lo que sobra, y lo que sobra suele ser lo técnico, que ya vive en el otro documento.

Mira la plantilla de la firma y la extensión que anota el borrador. La cifra que necesitas sale de restar, no de leer una celda.

Quien decide lee la primera frase y, con suerte, la segunda. Por eso el resumen abre con la conclusión y con lo que hay que decidir y para cuándo; después vienen los pocos hallazgos que más pesan, contados por su efecto en el negocio, y al final, el plan por equipo y lo que no se probó. Las siglas técnicas y los nombres de rutas no van: van en el informe técnico.

El borrador abre con una frase llena de términos que el lector no usa. Reescribirla es el trabajo de esta tarea.

Cada documento se redacta pensando en alguien concreto, y el cliente casi siempre lo dice: en encargo/lectores.txt está quién lee cada documento y qué decide. El resumen ejecutivo se escribe para quien tiene que tomar una decisión con él, y esa decisión es la que va en su segunda sección.