Idée principale

La spécification, la documentation de support, le document de cadrage sont souvent défendus par leur clarté : ils sont compréhensibles par tous, exploitables en réunion, partageables avec les équipes, utilisables sans compétence technique. Ces qualités sont réelles, mais ce sont des qualités d'accès, pas des qualités d'information.

La raison d'être de cette couche est une contrainte de lectorat : la plupart des Product Managers, des commerciaux et des agents de support ne travaillent pas dans le dépôt. Il fallait donc un objet intermédiaire, moins fiable que le code mais lisible par ceux qui décident. Tant que cette contrainte tenait, la couche en langage naturel était la moins mauvaise solution disponible — et personne n'avait à choisir entre la fiabilité et la lisibilité, puisqu'une seule des deux était atteignable.

Ce qui suit de là : le jour où l'accès à la source cesse d'être réservé à ceux qui savent la lire, l'argument qui justifiait la couche disparaît, alors que la couche, elle, reste en place.

Pourquoi c'est important

C'est ce qui empêche de lire l'abandon progressif de la documentation comme un relâchement. La couche n'était pas défendue pour elle-même, elle compensait une incapacité d'accès ; quand la compensation devient facultative, l'artefact perd son fondement sans que personne ne l'ait décidé.

Cela donne aussi un test à appliquer à n'importe quel document intermédiaire : à quelle incapacité d'accès répond-il ? Si la réponse est « à aucune », il duplique une information qui existe ailleurs, mieux tenue.

Nuances et limites

L'accès n'est pas tout. Un document en langage naturel porte aussi l'intention et le contexte métier, que le dépôt ne contient pas — cette part-là ne disparaît pas quand la barrière d'accès tombe.

Et le fait de pouvoir lire le code par l'intermédiaire d'un outil n'est pas le fait de le comprendre : la barrière se déplace vers la culture technique plutôt que de s'effacer.

Questions ouvertes

• Quelle part d'une spécification tient au contexte métier, donc survit à la levée de la barrière d'accès ?