Idea

Un repositorio completo sobre un perímetro sirve a todos sus oficios, un repositorio a medias sobre cinco no sirve a nadie

Info

Escrito originalmente en francés. Traducido por IA — se ha preservado el sentido, no la prosa.

Idea principal

La rentabilidad de la descripción de un producto no sigue el número de fichas escritas, sigue la completitud de un perímetro. Un bloque enteramente descrito —la facturación, digamos— responde a las preguntas del soporte, de la preventa, de la formación y de los desarrolladores que intervienen en él, y lo hace sin necesidad de comprobar en otra parte. Cinco bloques descritos a medias no evitan ninguna de esas comprobaciones: en cada pregunta hay que volver a abrir el código para saber si la respuesta que falta falta de verdad.

La razón es asimétrica. Una descripción parcial solo aporta valor si se sabe por dónde pasa su frontera; si no, su usuario debe contemplar siempre que esté muda, y su coste de verificación vuelve intacto.

De ahí la condición de explotación: terminar un bloque antes de abrir otro. Contradice la pendiente natural de un trabajo así, que es sobrevolar ampliamente para exhibir una cobertura halagadora.

Por qué es importante

Eso da una regla de secuenciación oponible a la presión de mostrar avance: el hito útil es "este perímetro está terminado", nunca "el n por ciento del producto está cubierto".

Vale para otros proyectos de conocimiento —una documentación, un glosario, una base de tests— cuyo uso solo arranca en el momento en que un usuario puede dejar de dudar sobre una zona entera.

Matices y límites

El razonamiento supone perímetros realmente separables. En un producto donde todo depende de todo, ningún bloque se termina sin desbordarse, y la regla se convierte en una instrucción de parada arbitraria en lugar de una condición de rentabilidad.

Y una cobertura amplia, aunque parcial, conserva una utilidad propia: sirve para comparar los ángulos entre sí y detectar dónde el producto se conoce mal.

Preguntas abiertas

  • ¿Cómo anunciar la frontera de un perímetro descrito para que un lector sepa, sin pensarlo, si su pregunta cae dentro o fuera?