Aller au contenu
EngineerPlateforme
Menu
Design
Français

Engineer / Plateforme / Portfolio

Une norme d'historique pour 4 dépôts

Appliqué à quatre dépôts une même norme d'historique — commits conventionnels, sans emojis ni mention d'attribution, imposés par un hook de message de commit — et 48 documents d'instructions régissant le travail.

Situation. Quatre dépôts construits sur dix‑huit mois par une seule personne constituent la situation où il est le plus facile de sauter les procédures, car il n’y a personne avec qui se coordonner et le coût d’un historique illisible est entièrement payé par un soi futur qui ne s’est pas encore plaint. C’est aussi la situation où un historique incohérent est le plus probable, chaque dépôt pouvant dériver vers ses propres habitudes sans rien pour les rapprocher.

Tâche. Une norme d’historique et une norme d’instructions devaient s’appliquer à chaque dépôt dans lequel le travail est rédigé, et être imposées mécaniquement plutôt que mémorisées.

Action. La norme de commit est un préfixe conventionnel nommant le type de modification et un périmètre, un sujet sous une longueur fixée, aucun emoji et aucune mention d’attribution finale — ce dernier point parce qu’une mention créditant un outil n’est pas un fait sur la modification, et que l’historique sert aux faits sur les modifications. Un hook de message de commit rejette toute non‑conformité dans chaque dépôt portant du travail ; la norme est donc une propriété du dépôt plutôt que de la personne qui commite. La répartition du plus grand dépôt montre ce qu’a réellement été le travail : 156 commits de fonctionnalités, 133 corrections, 128 de documentation, 81 de maintenance, 26 de refactorisation, 20 de style, 5 de performance et 3 de tests. La documentation est assez proche des corrections pour mériter l’attention, conséquence de la seconde moitié du dispositif — 48 documents d’instructions répartis dans les quatre dépôts, chacun couvrant un domaine, chacun écrit comme des règles plutôt qu’une description, tous accessibles depuis un document d’entrée unique par dépôt pour avoir un seul point de départ. Un linter de documentation impose des budgets de taille par fichier et l’appartenance à l’index, afin que l’ensemble reste navigable au lieu de devenir une archive.

Résultat. Quatre dépôts partagent un format d’historique et une structure d’instructions, tous deux imposés par des hooks plutôt que par la discipline. Cela ne rend pas l’historique bon : le format est contrôlé, pas le contenu, et un sujet conforme qui ne décrit rien passe exactement aussi bien qu’un sujet qui explique la modification.

Contact

Vous cherchez encore à préciser vos besoins ?

Dites-nous ce qui ne fonctionne pas ou ce que vous essayez de construire. Nous vous dirons ce que cela demanderait, son coût approximatif et si nous sommes les bonnes personnes pour le réaliser.

À partir de 1 400 DKK de l'heure, hors TVA — et un tarif horaire réduit pour une réservation plus longue.

welcome@engineer.company +45 50 10 61 84 Copenhague, Danemark