Des identifiants publies, donc tenus

ST-01Un identifiant publié ne change jamais de sens

Le jour où un identifiant devrait désigner autre chose, on en publie un nouveau et on déprécie l'ancien. Réutiliser un code pour un sens différent casserait silencieusement le travail de ceux qui s'y appuient, et un tiers n'a aucun moyen de s'en apercevoir.

ST-02Un identifiant retiré n'est jamais réattribué

Une fois publié, un code est consommé pour toujours, même après son retrait. Le réattribuer ferait pointer d'anciennes données vers un objet qui n'a rien à voir.

ST-03Un retrait passe par une dépréciation annoncée

Un identifiant qui doit disparaître est d'abord marqué déprécié, avec son remplaçant et sa date de retrait, et il reste servi au moins 24 mois. Une disparition sans préavis est une rupture d'interface, quelle que soit la qualité de la raison.

ST-04Le libellé peut être corrigé, l'ancre de sens ne bouge pas

Une coquille se corrige sans cérémonie. Ce qui est tenu est le sens, pas la formulation : le balayage compare une ancre de sens courte et non le texte affiché.

ST-05L'identifiant n'est pas traduit

Un identifiant est unique et stable, seul son libellé se traduit. Un vocabulaire dont les codes changent avec la langue n'est plus un vocabulaire.

ST-06En cas de doute, on ne publie pas

Trente identifiants tenus dix ans valent mieux que trois cents provisoires. Publier plus tard ne coûte rien ; retirer coûte deux ans.