Idea principal

Un glosario de producto define palabras una por una: "pedido", "factura", "cliente". Cada entrada puede ser correcta, y el conjunto no enseña casi nada de lo que hace el software. El pedido descrito a solas sigue siendo una etiqueta. El mismo pedido realizado por un cliente, que contiene líneas, facturado en una factura, describe un producto — porque los verbos llevan consigo lo que el negocio autoriza y prohíbe.

Un repositorio que nombra sus enlaces se distingue así de los tres artefactos que ya existían alrededor del producto: el glosario, que define sin relacionar; el esquema de base de datos, que relaciona tablas según restricciones técnicas y no según el negocio; la documentación, que narra para un lector humano y no expone ninguna estructura consultable.

La restricción operativa cabe en una regla de redacción: ningún enlace se escribe "está relacionado con". Cada enlace lleva un verbo y las cardinalidades de ambos lados — un pedido lo realiza un solo cliente, contiene al menos una línea.

Por qué es importante

Es lo que hace la descripción aprovechable más allá de la lectura. Un enlace nombrado se verifica, se prueba, se contradice; "está relacionado con" no se contradice nunca, así que no prueba nada. Es también lo que permite a un agente responder a una pregunta de comportamiento sin abrir el código: la respuesta está en el camino entre dos fichas.

Y da un criterio de parada a la redacción de una ficha: mientras los enlaces sean vagos, la ficha no está escrita, aunque todos los campos estén rellenos.

Matices y límites

El verbo preciso tiene un coste: obliga a decidir casos que la definición dejaba en la sombra — ¿un pedido generado automáticamente está realizado por alguien? Ese coste es justamente lo que hace aflorar preguntas de producto, pero ralentiza la primera pasada.

Y una red de enlaces correctos no dice nada sobre su propia completitud: un conjunto de fichas que solo se citan entre sí se cierra mucho antes de haber cubierto el producto.

Preguntas abiertas

• ¿Hasta dónde hay que normalizar el vocabulario de los verbos mismos antes de que dos redactores dejen de nombrar la misma relación de dos maneras?