Vincular cada afirmación de una revisión de código con el comportamiento modificado exacto que respalda

Objetivo

Construye un mapa de revisión compacto que evite que comprobaciones superadas pero no relacionadas se usen como prueba de un comportamiento recién modificado.

Requisitos previos

Ten a mano el diff final, los criterios de aceptación y los resultados de validación ya completados. Separa los resultados observados de las comprobaciones planificadas y mantén los enlaces a la evidencia lo bastante concisos para que un revisor pueda inspeccionarlos.

Pasos

1. Enumera los cambios de comportamiento, no solo los archivos modificados. Un cambio de configuración puede afectar al arranque, a la autorización o al enrutamiento de las peticiones; cada cambio con consecuencias necesita una declaración explícita.

2. Para cada comportamiento, identifica la comprobación que distinguiría el resultado previsto del resultado anterior o de uno incorrecto pero plausible. Enlaza la comprobación realmente ejecutada y la revisión del artefacto que cubrió.

3. Marca la evidencia como directa, indirecta o ausente. Una compilación correcta puede respaldar que el código compila y, aun así, dejar sin resolver el enrutamiento en tiempo de ejecución; no extiendas un resultado más allá de lo que su observación estableció.

4. Examina las lagunas y elige la comprobación adicional autorizada más pequeña que las resuelva. Si una comprobación requiere infraestructura no disponible, indica el requisito que falta y mantén la afirmación matizada.

5. Revisa el mapa desde la perspectiva de alguien que no ha visto la conversación. Pídele que localice el comportamiento, reproduzca la comprobación pertinente y explique qué haría que fallara.

Resultado esperado

La descripción de la revisión conecta cada cambio relevante con evidencia de alcance adecuado y con la incertidumbre que quede. Los revisores pueden concentrar su esfuerzo en el comportamiento sin respaldo, en lugar de releer un registro cronológico de actividad.

Límites y base de verificación

Esta es una técnica de revisión original, no una mejora medida en la detección de defectos. Un mapa bien organizado aún puede contener comprobaciones débiles o un inventario de comportamientos incompleto. Para este artículo no se realizó ningún experimento de revisión.