Idée principale

Un glossaire produit définit des mots un par un : « commande », « facture », « client ». Chaque entrée peut être juste, et l'ensemble n'apprend presque rien de ce que le logiciel fait. La commande décrite seule reste une étiquette. La même commande passée par un client, contenant des lignes, facturée dans une facture, décrit un produit — parce que les verbes portent ce que le métier autorise et interdit.

Un référentiel qui nomme ses liens se distingue ainsi des trois artefacts qui existaient déjà autour du produit : le glossaire, qui définit sans relier ; le schéma de base de données, qui relie des tables selon des contraintes techniques et non selon le métier ; la documentation, qui raconte pour un lecteur humain et n'expose aucune structure interrogeable.

La contrainte opératoire tient en une règle de rédaction : aucun lien ne s'écrit « est lié à ». Chaque lien porte un verbe et les cardinalités des deux côtés — une commande est passée par un seul client, elle contient au moins une ligne.

Pourquoi c'est important

C'est ce qui rend la description exploitable au-delà de la lecture. Un lien nommé se vérifie, se teste, se contredit ; « est lié à » ne se contredit jamais, donc ne prouve rien. C'est aussi ce qui permet à un agent de répondre à une question de comportement sans ouvrir le code : la réponse tient dans le chemin entre deux fiches.

Et cela donne un critère d'arrêt à la rédaction d'une fiche : tant que les liens sont vagues, la fiche n'est pas écrite, même si tous les champs sont remplis.

Nuances et limites

Le verbe précis a un coût : il oblige à trancher des cas que la définition laissait dans l'ombre — une commande générée automatiquement est-elle passée par quelqu'un ? Ce coût est justement ce qui fait remonter des questions produit, mais il ralentit la première passe.

Et un réseau de liens justes ne dit rien de sa propre complétude : un ensemble de fiches qui ne se citent qu'entre elles se referme bien avant d'avoir couvert le produit.

Questions ouvertes

• Jusqu'où faut-il normaliser le vocabulaire des verbes eux-mêmes avant que deux rédacteurs cessent de nommer la même relation de deux façons ?