Résumé et motivation

Une demande de fusion (pull request) est une proposition de fusionner un ensemble de changements d'une branche d'un dépôt de contrôle de version vers une autre, accompagnée de la conversation sur l'opportunité de la fusion. Dans beaucoup d'équipes, c'est la porte formelle entre « l'auteur pense que ça marche » et « l'équipe convient que ça peut partir en production ». La conversation est une forme de revue de code : une personne autre que l'auteur lit le changement, pose des questions et l'approuve ou demande des révisions. Certaines plateformes appellent la même chose une merge request ; ce sujet emploie « demande de fusion » pour les deux.

La revue vaut d'être mesurée pour une raison simple. Dans la vision de la livraison par le flux, un élément de travail passe l'essentiel de sa vie à attendre, et la revue est l'une des attentes qui se situent entièrement sous le contrôle de l'équipe. Un goulot d'étranglement de plateforme partagée ou une dépendance externe exige que d'autres gens changent. Une demande de fusion qui attend deux jours un premier regard n'exige que les habitudes de l'équipe elle-même pour changer. Les mesures de flux de ce livre (voir le sujet 2.1, Mesures de flux, et le sujet 2.2, Délai de livraison, temps de cycle et efficacité du flux) donnent le vocabulaire général. Ce sujet zoome sur une étape du cycle et lui donne ses propres instruments.

Les points de vue agile et ITIL se rencontrent ici de façon utile. Du point de vue agile, la revue est une boucle de rétroaction et un mécanisme d'enseignement. Elle diffuse la connaissance de la base de code, détecte tôt les défauts et fait respecter les accords de travail et la définition de terminé de l'équipe. Du point de vue ITIL, la même activité soutient plusieurs pratiques. Dans ITIL 4, la pratique de développement et de gestion des logiciels couvre la façon dont les logiciels sont construits et vérifiés, la maîtrise des changements couvre la façon dont les changements sont évalués et autorisés, et la gestion des déploiements couvre la façon dont les changements parviennent à l'environnement de production. Une demande de fusion relue par les pairs est, pour beaucoup d'organisations, la preuve qu'un changement standard a été évalué avant sa publication. Traiter la revue comme une activité mesurée et améliorable sert les deux visions : l'équipe agile veut une rétroaction plus rapide, et la pratique ITIL veut une garantie fiable que les changements ont été vérifiés.

Le risque à garder à l'esprit tout du long est que la vitesse de revue et la qualité de revue se séparent facilement. Une équipe peut diviser par deux son temps jusqu'à la première revue en approuvant tout à vue, et le tableau de bord montrera un triomphe tandis que la base de code se dégrade. La loi de Goodhart s'applique ici avec une force inhabituelle (voir le sujet 1.2, Loi de Goodhart et psychologie des métriques), parce que les chiffres sont peu coûteux à collecter, visibles de tous et trivialement faciles à déplacer sans changer ce qu'ils étaient censés représenter. Chaque recommandation ci-dessous est écrite dans cet esprit.

L'auteur a ouvert la demande de fusion et un relecteur l'évalue. Un tour de revue est une boucle « l'auteur pousse, le relecteur répond ». La reprise est un changement fait après un commentaire de revue, ou après la fusion, pour corriger ce que la première version avait de faux. L'intégration continue (CI) est la pratique qui consiste à fusionner souvent le travail dans une ligne partagée et à vérifier automatiquement chaque fusion ; voir l'intégration continue.

Toutes les métriques de ce sujet décrivent des équipes et des dépôts. Elles ne classent jamais les relecteurs ni les auteurs. Les comptes de revue au niveau individuel sont faciles à extraire et tentants à utiliser, et le faire transforme une pratique de collaboration en concours (voir le sujet 9.1, Santé de l'équipe et expérience des développeurs).

Principes clés

  • L'attente domine la relecture. Dans la plupart des équipes, la plus grande part du temps de revue est celle où la demande de fusion reste non lue, non la discussion une fois qu'un relecteur commence. Mesurez l'attente avant de mesurer la conversation.
  • Les petits changements sont relus plus vite et mieux. La taille est l'un des rares leviers qui améliorent à la fois la vitesse et la minutie, parce qu'un relecteur peut tenir un petit changement dans sa tête.
  • La vitesse sans examen n'est pas une amélioration. Chaque mesure de vitesse de ce sujet a besoin d'une contrepartie de qualité, et la paire se lit ensemble.
  • La revue est une capacité d'équipe, non personnelle. La charge devrait se répartir dans l'équipe. Une métrique qui montre de la concentration désigne un problème de conception de l'équipe, jamais une personne à louer ou à blâmer.
  • Les distributions valent mieux que les moyennes. Les temps de revue ont une longue queue de demandes de fusion bloquées ; rapportez donc la médiane et un percentile élevé (voir le sujet 1.6, Culture statistique pour les métriques de service).
  • Définir l'horloge, puis la laisser tranquille. Indiquez quand l'horloge démarre et s'arrête, quels événements la suspendent et quelle activité automatisée est exclue, et écrivez-le là où vivent les données (voir le sujet 1.5, Sources de données et instrumentation).
  • Les métriques de revue servent l'équipe qui détient le travail. Elles alimentent la rétrospective de l'équipe elle-même, elles ne sont pas un tableau de score pour quelqu'un d'autre.

Définitions des métriques

Les horloges ci-dessous supposent que la plateforme de contrôle de version enregistre les heures d'événement de l'ouverture, des demandes de revue, des commentaires, des approbations, des poussées et des fusions. Les brouillons, les demandes de fusion ouvertes par des robots et celles closes sans fusion sont exclus sauf indication contraire d'une ligne. Les « heures ouvrées » désignent les heures de travail déclarées de l'équipe, de sorte qu'une demande de fusion ouverte le vendredi soir n'accumule pas un week-end d'attente.

Métrique Définition Formule Unité Source de données Pratique ITIL Équivalent agile Cadence
Temps jusqu'à la première revue Attente entre le moment où une demande de fusion devient prête pour la revue et la première réponse humaine substantielle L'horloge démarre quand la demande de fusion quitte le statut de brouillon ou est ouverte prête, s'arrête au premier commentaire de revue, à la première demande de changement ou à la première approbation par quelqu'un d'autre que l'auteur ; les commentaires de robots et d'auteur et les simples changements d'étiquette sont exclus. Rapportez la médiane et le 85e percentile en heures ouvrées heures ouvrées Historique d'événements de la plateforme de contrôle de version Développement et gestion des logiciels ; maîtrise des changements Accord de travail sur la réactivité de la revue ; flux du travail en cours Hebdomadaire
Temps de cycle de la revue Temps total entre prêt pour la revue et fusion L'horloge démarre quand la demande de fusion est prête pour la revue, s'arrête à la fusion ; les demandes de fusion closes sans fusion sont exclues et comptées séparément. Rapportez la médiane et le 85e percentile en heures ouvrées heures ouvrées Historique d'événements de la plateforme de contrôle de version Gestion des déploiements ; maîtrise des changements Temps de cycle de l'étape de revue sur le tableau de l'équipe Hebdomadaire
Taille de la demande de fusion Quantité de changement dans une demande de fusion Lignes ajoutées plus lignes supprimées, hors fichiers générés, fichiers de verrouillage, code tiers inclus et simples renommages, tels que listés dans les règles d'exclusion du dépôt. Rapportez la médiane et le 85e percentile par demande de fusion fusionnée lignes modifiées Statistiques de différences de la plateforme de contrôle de version Développement et gestion des logiciels Petite taille de lot ; découpage des récits Hebdomadaire
Tours de revue Nombre de boucles de poussée de l'auteur et de réponse du relecteur avant la fusion Nombre de cycles distincts « changements demandés » ou commentaire puis poussée par demande de fusion fusionnée ; la première soumission est le tour zéro et les échecs de contrôles automatisés sont exclus. Rapportez la médiane et le 85e percentile nombre Événements de revue et de poussée de la plateforme de contrôle de version Amélioration continue ; développement et gestion des logiciels Signal de reprise à l'étape de revue ; définition de terminé Hebdomadaire
Concentration de la charge de revue Inégalité de la répartition du travail de revue dans une équipe Part des revues terminées de l'équipe traitées par les deux relecteurs les plus occupés sur 4 semaines glissantes ; les revues de sa propre demande de fusion et celles de robots sont exclues. Rapportée pour l'équipe, jamais par nom pourcentage Événements de revue de la plateforme de contrôle de version, agrégés par équipe Amélioration continue ; gestion des connaissances Propriété collective du code ; responsabilité collective Mensuelle
Nombre de demandes de fusion périmées Demandes de fusion ouvertes plus longtemps que la limite convenue de l'équipe Demandes de fusion encore ouvertes et pas en brouillon dont l'âge depuis « prêt pour la revue » dépasse la limite de l'équipe, comptées à l'heure de l'instantané ; les brouillons sont exclus nombre Liste des demandes de fusion ouvertes de la plateforme de contrôle de version Maîtrise des changements ; amélioration continue Ancienneté de l'élément de travail ; limite de WIP Hebdomadaire
Taux de correction après fusion Part des demandes de fusion fusionnées suivies peu après d'un changement correctif Demandes de fusion fusionnées suivies dans les 14 jours d'un correctif, d'une annulation ou d'un correctif urgent lié au même changement / demandes de fusion fusionnées dans la période ; le travail de suivi planifié étiqueté comme tel est exclu pourcentage Historique du contrôle de version, tickets liés et enregistrements d'incidents ou de changements Maîtrise des changements ; gestion des incidents Qualité intégrée ; définition de terminé Mensuelle

Le temps jusqu'à la première revue est le levier le plus important et la métrique par laquelle la plupart des équipes devraient commencer. Le temps de cycle de la revue en est la mesure de résultat et fait partie des délais de livraison plus longs discutés au sujet 2.2. La fenêtre de 14 jours et la limite de péremption sont des exemples ; chaque équipe choisit des valeurs adaptées à son rythme de publication et les écrit. Là où les chiffres alimentent le tableau plus large de la livraison, la famille DORA (voir le sujet 2.8, Métriques DORA) et les mesures d'échec de changement (voir le sujet 4.4, Échecs de changement et reprises) prennent le relais.

Recommandations

Mesurer l'attente avant le travail

1. Commencez par le temps jusqu'à la première revue. C'est généralement la plus grande contribution au temps de revue et la moins chère à améliorer. Instrumentez-le à partir de l'historique d'événements de la plateforme pour que personne n'ait rien à saisir. Rapportez la médiane et un percentile élevé, car une médiane de trois heures avec un 95e percentile de quatre jours signifie que certains changements sont oubliés.

2. Excluez les robots et les brouillons de l'horloge, et dites-le. Les contrôles automatisés, les robots de mise à jour de dépendances et les outils de formatage créent des commentaires en quelques secondes, et les compter fait paraître l'attente excellente. Démarrez l'horloge quand l'auteur marque le changement comme prêt, non quand la branche est poussée pour la première fois. Publiez ces règles à côté du graphique.

3. Employez des heures ouvrées, et écrivez le calendrier de l'équipe. Une demande de fusion ouverte tard le vendredi ne devrait pas porter un week-end d'attente. Une équipe répartie sur plusieurs fuseaux horaires a besoin d'une règle sur les heures qui comptent, et la réponse honnête est souvent que le coût de transmission entre fuseaux est la chose qui vaut d'être vue. Énoncez le choix et gardez-le stable.

Façonner le travail pour qu'il soit relisible

4. Gardez des demandes de fusion petites, et traitez la taille comme une habitude d'équipe. Suivez la médiane et le 85e percentile de la taille, et regardez les grosses comme un ensemble plutôt que comme des échecs individuels. Les équipes constatent généralement que les gros changements viennent de quelques causes : un travail pas assez finement découpé, un mélange de remaniement et de nouveau comportement, ou une trop longue attente avant de fusionner. Découpez le travail pour que chaque demande de fusion fasse une seule chose, ce qui correspond aussi au principe des petits lots qui sous-tend le développement sur tronc commun et le déploiement fréquent.

5. Ne fixez pas de plafond de taille comme objectif. Une limite comme « pas plus de 400 lignes » invite à fractionner un changement en morceaux artificiels qui sont individuellement illisibles ou qui cassent la construction fusionnés seuls. Employez la taille comme déclencheur de conversation en rétrospective, et donnez à l'équipe des techniques de découpage, comme les bascules de fonctionnalité, le remaniement préparatoire dans sa propre demande de fusion et la fusion derrière un drapeau.

6. Rendez la demande de revue explicite. Une demande de fusion qui ne nomme aucun relecteur attend un volontaire, et les volontaires sont rares. Convenez dans l'accord de travail de qui est sollicité, comment l'équipe est prévenue et quelle est l'attente de réponse. Un tour de rôle de revue partagé, ou un créneau de revue quotidien, réduit généralement l'attente plus que n'importe quel réglage d'outil.

Répartir la charge et la connaissance

7. Surveillez la concentration de la charge comme un risque d'équipe. Si deux personnes traitent la plupart des revues, leur disponibilité limite le flux de l'équipe, et leur absence l'arrête. Revoyez chaque mois la mesure de concentration, et agissez par la conception de l'équipe : faites tourner le relecteur par défaut, associez les nouveaux membres à des membres expérimentés et écrivez les zones du code que seule une personne peut relire. Ne publiez pas de classement par personne.

8. Utilisez la revue pour partager la connaissance, et protégez cet objectif. La valeur à long terme de la revue inclut l'apprentissage, la propriété partagée et la cohérence de style, autant que la détection de défauts. La programmation en binôme et la programmation en groupe déplacent une partie de cet échange plus tôt dans le processus ; là où un binôme a déjà travaillé sur un changement, une revue plus légère est raisonnable. Faites du choix une décision d'équipe, écrite dans l'accord de travail, afin que « fait en binôme, donc relu légèrement » soit une règle visible et non une excuse.

Maîtriser la revue elle-même

9. Laissez l'automatisation traiter ce qu'elle fait bien. Le formatage, l'analyse de style et les contrôles de base relèvent de la chaîne, pour que l'attention humaine aille à la conception, à l'exactitude et au risque. L'analyse statique de programmes et les tests automatisés réduisent le nombre de tours de revue triviaux. Les tours restants en disent alors davantage sur la conversation de conception et moins sur les désaccords de style.

10. Lisez les tours de revue comme un signal de clarté, non comme un compte de fautes. De nombreux tours peuvent signifier que l'exigence était floue, que l'auteur manquait de contexte, que le relecteur demandait des changements de goût ou que le changement était gros. Zéro tour sur chaque demande de fusion peut signifier un excellent travail comme l'absence de regard. Échantillonnez une poignée de demandes de fusion aux tours inhabituellement nombreux ou rares et lisez-les ensemble en équipe.

Associer vitesse et qualité, et garder le temps visible

11. Montrez toujours une contrepartie de qualité à côté de la vitesse de revue. Le taux de correction après fusion, les incidents liés aux changements récents et la part de défauts trouvés après la publication en sont les partenaires naturels (voir le sujet 4.4, Échecs de changement et reprises). Si le temps de revue s'améliore pendant que le taux de correction empire, l'équipe a échangé l'assurance contre la vitesse, et la solution est une conversation plutôt qu'un objectif. Montrez les deux sur le même graphique.

12. Reliez la revue au tableau du flux et au travail non planifié. Une revue plus rapide n'aide que si l'étape suivante ne se contente pas de mettre le travail en file (voir le sujet 2.3, Travail en cours et théorie des files d'attente). Les demandes de revue urgentes qui interrompent le travail planifié ont un coût propre (voir le sujet 2.9, Travail opérationnel et travail non planifié).

Vecteurs de détournement et garde-fous

Métrique Comment elle est détournée Métrique ou pratique de garde-fou associée
Temps jusqu'à la première revue Poster un rapide « ça me paraît bon » ou un émoji comme première réponse ; assigner un robot ou un relecteur complaisant ; ne marquer une demande de fusion prête qu'après que quelqu'un a convenu à l'avance de la regarder Taux de correction après fusion ; échantillon d'approbations sans commentaire ; exiger dans l'accord de travail que les premières réponses soient substantielles
Temps de cycle de la revue Fusionner sans attendre la revue ; fractionner un changement en minuscules morceaux pour passer plus vite ; clore et rouvrir une demande de fusion pour réinitialiser l'horloge Compter les demandes de fusion closes puis rouvertes ; tours de revue ; taux de correction après fusion ; règles de branche protégée qui exigent une approbation
Taille de la demande de fusion Exclure des fichiers du compte ; fractionner un changement unique en morceaux qui ne se comprennent pas séparément ; gonfler la taille avec du code généré Revoir les règles d'exclusion chaque trimestre ; vérifier que les morceaux fractionnés se construisent et passent les tests seuls ; lire un échantillon des plus petits et des plus grands
Tours de revue Approuver au premier passage pour garder le compte bas ; déplacer la discussion vers la messagerie pour qu'elle ne laisse pas de trace ; des auteurs qui poussent de nombreux correctifs en une validation pour cacher les tours Taux de correction après fusion ; échantillon de demandes de fusion à zéro tour ; garder la discussion dans la demande de fusion
Concentration de la charge de revue Fractionner les revues en nombreuses petites approbations pour répartir le compte ; confier les revues à ceux qui ont du temps libre mais pas la connaissance Examiner la connaissance du relecteur pour les zones à risque ; surveiller le taux de correction après fusion par zone ; garder la métrique au niveau de l'équipe
Nombre de demandes de fusion périmées Clore les demandes de fusion périmées sans fusion ; les convertir en brouillons pour les cacher ; relever la limite de péremption Compte des demandes de fusion closes sans fusion ; compte des brouillons de longue durée ; revoir la limite avec l'équipe chaque trimestre
Taux de correction après fusion Consigner les corrections sous un nouvel élément de travail sans lien ; étiqueter le travail correctif comme suivi planifié ; éviter la métrique en retardant la correction au-delà de la fenêtre Comparer avec les données d'incidents et d'échecs de changement ; échantillon d'éléments de suivi ; audit des étiquettes employées

Une lecture saine est une lecture calme. Le temps jusqu'à la première revue est court et la queue l'est aussi, de sorte qu'aucune demande de fusion n'attend des jours. La taille se situe dans une plage que l'équipe trouve facile à lire, avec quelques gros changements que l'équipe sait expliquer. Les tours de revue sont bas mais non nuls, la concentration de la charge est modérée, le nombre de périmées est petit et le taux de correction après fusion est stable. Quand un chiffre s'améliore fortement, quelqu'un devrait vérifier que son garde-fou associé n'a pas bougé dans le mauvais sens.

Compromis : avantages et inconvénients

Approche Force Faiblesse
Revue rapide avec des attentes de réponse strictes Boucles de rétroaction courtes ; moins de perte de contexte pour l'auteur ; moins de travail en cours Pression pour approuver vite ; interrompt le travail concentré
Revue lente et minutieuse Lecture attentive de la conception et du risque ; meilleur transfert de connaissance Temps de cycle plus long ; des lots plus gros s'accumulent ; les auteurs passent à autre chose et perdent le contexte
Petites demandes de fusion Plus faciles à lire et à annuler ; flux plus fluide Plus de frais par changement ; peut fragmenter une fonction en étapes confuses
Grosses demandes de fusion Moins de transmissions ; fonction entière visible d'un coup Les revues deviennent superficielles ; plus difficiles à annuler ; longues attentes
Approbation exigée d'un responsable nommé Responsabilité claire pour les zones à risque ; appuie l'autorisation des changements Crée un goulot d'étranglement et un point de défaillance unique
Contrôles automatisés avant la revue humaine Libère les personnes pour la conception et le risque ; cohérent Peut créer une fausse confiance ; demande de l'entretien

Aucune politique ne l'emporte seule. Le but est de raccourcir l'attente tout en préservant l'examen, et la voie habituelle est de plus petits changements, des attentes de revue claires, une forte automatisation des contrôles courants et un accord d'équipe sur ce qu'est une bonne revue. Les métriques de revue sont plus utiles comme questions pour une rétrospective et moins utiles comme objectifs.

Questions à discuter avec votre équipe

1. Où une demande de fusion passe-t-elle l'essentiel de sa vie, à attendre ou à être relue ? Demandez à l'équipe de deviner avant de regarder les données, puis montrez la répartition entre le temps jusqu'à la première revue et le temps restant jusqu'à la fusion. La plupart des groupes sont surpris de voir combien est de l'attente. L'animateur doit noter quelles devinettes étaient fausses et demander ce que chacune dit de la façon dont l'équipe vit la revue. Terminez par un changement qui s'attaque à la plus grande attente.

2. À quoi ressemble une bonne revue dans cette équipe, et comment un étranger le dirait-il ? Listez les comportements que l'équipe valorise, comme interroger la conception, vérifier les tests et expliquer la raison d'une demande. Demandez ensuite lesquels laissent une trace visible dans la demande de fusion. Discutez de la manière de distinguer une première réponse substantielle d'une réponse symbolique sans surveiller les individus. Convenez d'une courte description écrite à mettre dans l'accord de travail.

3. À partir de quelle taille est-ce trop gros pour nous, et que faisons-nous quand le travail est vraiment gros ? Regardez la distribution des tailles et choisissez quelques-unes des plus grosses demandes de fusion. Demandez pourquoi chacune était grosse et si elle aurait pu être découpée. Discutez de techniques comme les bascules de fonctionnalité, le remaniement préparatoire et la fusion derrière un drapeau. L'animateur doit résister à la fixation d'une limite numérique et convenir plutôt d'une habitude que l'équipe essaiera pendant un mois.

4. Qui relit notre code le plus risqué, et que se passe-t-il quand ces personnes sont absentes ? Associez les zones du code aux personnes qui peuvent bien les relire. Regardez la concentration de la charge et les zones à un seul relecteur qualifié. Discutez de la manière de former un second relecteur dans chacune, par le binômage ou la rotation des affectations. Gardez la conversation sur la résilience de l'équipe, non sur un classement de la charge de quiconque.

5. Si notre vitesse de revue doublait demain, que voudrions-nous qui soit vrai de la qualité ? Demandez au groupe de nommer les signaux de qualité qu'il surveillerait, comme les corrections après fusion, les incidents liés aux changements récents ou le nombre d'annulations. Vérifiez si ces signaux sont actuellement visibles à côté du graphique de vitesse. Discutez de ce qui serait un signe précoce que la vitesse a été achetée aux dépens de l'examen. Convenez de la contrepartie à afficher sur le tableau de bord.

6. Quels chiffres de revue serions-nous tentés d'améliorer d'une manière qui n'aide pas ? Parcourez chaque métrique et demandez comment une personne sous pression pourrait la faire paraître meilleure sans rien améliorer. Comparez les réponses avec le tableau de détournement ci-dessus et ajoutez les idées propres de l'équipe. Le but est de nommer le risque avant qu'il se produise. Convenez du garde-fou qui sera revu avec chaque métrique.

Quatre perspectives

Équipes produit et livraison

Les équipes de livraison détiennent le processus de revue et devraient détenir ses métriques. Elles profitent le plus du raccourcissement de l'attente par de simples accords : un créneau de revue quotidien, un processus de demande clair et de petits changements. Elles devraient se servir des chiffres en rétrospective, garder bas le travail en cours et résister à la tentation d'optimiser un seul graphique. La revue est aussi l'endroit où les nouveaux membres apprennent la base de code ; protégez donc cet objectif.

Équipes de service et d'exploitation

Les équipes d'exploitation rencontrent la revue là où le code d'infrastructure, la configuration et l'automatisation des guides d'exploitation sont modifiés par des demandes de fusion. Pour elles, la revue fait souvent partie de la façon dont un changement standard est approuvé et justifié (voir le sujet 4.3, Métriques de maîtrise des changements). Elles devraient convenir des changements qui exigent une revue par une seconde personne, de la rapidité de la revue des correctifs urgents et de la façon dont les changements d'urgence sont revus après coup, afin qu'un correctif précipité soit quand même examiné. Une revue mince sur un changement risqué se manifeste plus tard sous forme d'incident.

Direction et gouvernance

Les dirigeants devraient traiter les métriques de revue comme des signaux de santé et de flux de l'équipe, non comme des scores de productivité. Ils devraient demander la mesure de qualité associée chaque fois qu'un chiffre de vitesse est rapporté, soutenir le temps que prend une revue soignée et éviter de comparer des équipes sur le temps de revue brut, puisque les dépôts et les risques diffèrent. Les instances de gouvernance peuvent utiliser les preuves de revue dans l'assurance des changements, à condition d'accepter qu'un processus de revue documenté et échantillonné est plus solide qu'un compte d'approbations.

Clients et utilisateurs

Les clients ne voient pas les demandes de fusion, mais ils en ressentent les résultats : la rapidité avec laquelle un correctif arrive et la fréquence à laquelle une version apporte un nouveau défaut. De courtes attentes de revue aident les correctifs urgents à les atteindre plus tôt, et une revue réfléchie aide à tenir les défauts à distance. Là où un service a un historique de versions ou de défauts publié, les clients profitent de ce que l'équipe montre moins d'annulations et moins de corrections répétées avec le temps.

En pratique : un exemple d'ITIL agile

Le service informatique d'un hôpital régional exploite un service web de prise de rendez-vous des patients, construit par une équipe produit de sept personnes et exploité avec un petit groupe de fiabilité des sites. Tous les chiffres de cet exemple sont illustratifs.

Lors d'une revue trimestrielle, l'équipe constate que son temps de cycle de revue a une médiane de 26 heures ouvrées et un 85e percentile de 71 heures ouvrées (illustratif). La décomposition du cycle montre que le temps médian jusqu'à la première revue est de 19 heures ouvrées ; l'essentiel du retard est donc de l'attente. La taille des demandes de fusion a une médiane de 180 lignes et un 85e percentile de 900 lignes (illustratif), et les deux relecteurs les plus occupés traitent 68 pour cent des revues (illustratif). Le taux de correction après fusion est de 9 pour cent (illustratif).

L'équipe prend trois accords. Elle fixe un créneau de revue quotidien de 30 minutes, écrit dans son accord de travail l'attente d'une première réponse en un jour ouvré et fait tourner chaque semaine une charge « relire d'abord ». Elle adopte aussi une habitude de découpage du gros travail, avec des bascules de fonctionnalité pour que les fonctions partielles puissent être fusionnées sans danger. Elle ne fixe ni limite de taille ni objectif pour le temps jusqu'à la première revue.

Après deux mois, le temps médian jusqu'à la première revue tombe à 6 heures ouvrées et le 85e percentile du temps de cycle de la revue tombe à 34 heures ouvrées (illustratif). La concentration de la charge baisse à 52 pour cent (illustratif), et le taux de correction après fusion reste à 9 pour cent.

L'équipe attrape alors un risque de détournement. Un échantillon d'approbations montre qu'environ un tiers des premières réponses arrivent en quelques minutes et se lisent seulement « LGTM » sur des changements touchant la logique des rappels de rendez-vous. Le gain de vitesse était en partie réel et en partie un coup de tampon. Le taux de correction après fusion n'avait pas encore bougé parce que le code concerné s'exécute selon un cycle mensuel. L'équipe change l'accord de travail afin qu'une première réponse doive inclure soit une question, soit un commentaire sur une partie précise du changement, soit une note explicite de ce qui a été vérifié, et ajoute à son graphique de revue la part échantillonnée d'approbations sans commentaire. Elle convient aussi que les changements de la logique de rappel destinée aux patients exigent deux relecteurs, dont l'un issu du groupe d'exploitation. La décision, avec ses raisons, va dans le journal des décisions de l'équipe.

Perspective sectorielle

Startup. Une petite équipe peut relire en quelques minutes parce que tout le monde connaît le code, et le principal risque est de sauter la revue quand le temps manque. Gardez peu de métriques : le temps jusqu'à la première revue et la taille suffisent. Installez tôt l'habitude des petits changements, car elle est bien plus difficile à introduire une fois que la base de code et l'équipe ont grandi.

Petite entreprise. Il y a souvent un ou deux développeurs, ou un fournisseur extérieur, qui entretiennent le logiciel. La revue peut être faite par un seul collègue ou par le personnel du fournisseur. Demandez aux fournisseurs comment ils relisent et si les données des demandes de fusion peuvent être partagées, et gardez un registre simple de quels changements ont été relus par qui, car la revue est le principal contrôle contre les erreurs dans une petite équipe.

Grande entreprise. De nombreuses équipes, dépôts et règles d'approbation créent une grande variation. Standardisez les définitions des horloges et des exclusions pour que les données de plateforme soient comparables, mais ne classez pas les équipes par temps de revue brut, puisque le risque et la base de code diffèrent. Guettez les exigences de revue imposées pour l'audit qui ajoutent de l'attente sans ajouter d'examen, et cherchez des occasions de remplacer les approbations manuelles par des contrôles automatisés et une revue par échantillon.

Gouvernement et secteur public. La séparation des tâches, les pistes d'audit et les règles de marchés exigent souvent une approbation indépendante des changements. Traitez ces règles comme des données d'entrée de la conception : consignez qui a approuvé quoi et quand, et mesurez l'attente qu'elles créent. Là où des fournisseurs écrivent le code, précisez dans le contrat les preuves de revue et l'accès aux données (voir le sujet 8.5, Rapports réglementaires et gouvernementaux).

Dossier d'affaires : motivations, ROI et TCO

La motivation est de raccourcir la partie de la livraison qui est à la fois lente et maîtrisable, tout en gardant les bénéfices de la revue par les pairs : moins de défauts, connaissance partagée et piste d'audit. Les demandes de fusion en attente retiennent le travail terminé loin des utilisateurs, augmentent le coût de changement de contexte pour les auteurs et rendent les conflits de fusion plus probables à mesure que les branches vieillissent. Réduire l'attente rapporte donc par une livraison plus rapide, moins de reprises et moins de frustration.

Le coût de collecte de ces métriques est faible quand la plateforme de contrôle de version fournit un historique d'événements et une API. Les principaux coûts sont le temps de définir les horloges et les exclusions, de construire ou configurer le rapport et de revoir régulièrement les chiffres. Le coût le plus élevé est comportemental : le temps que les gens consacrent à relire promptement, qui concurrence d'autre travail. Ce temps est le véritable investissement, et il devrait être budgété plutôt que traité comme gratuit.

Le retour se voit dans un temps de cycle de revue plus court, moins de demandes de fusion périmées et un taux de correction après fusion stable ou en baisse. Évitez d'annoncer à l'avance un pourcentage d'amélioration précis, puisque les résultats dépendent du point de départ et de l'équipe. Un dossier crédible compare les distributions avant et après de l'équipe, avec sa contrepartie de qualité, plutôt que de citer des chiffres d'autres organisations. Le livre de 2018 Accelerate rapporte des recherches reliant des pratiques techniques et culturelles à la performance de livraison et constitue une source raisonnable pour l'argument général, mais les chiffres de votre équipe viennent de vos propres données.

Antimodèles et pièges

  • Classer les relecteurs ou les auteurs. Des classements individuels des revues terminées ou des lignes modifiées corrompent la collaboration. Rapportez au niveau de l'équipe et servez-vous des chiffres pour ajuster les habitudes de l'équipe.
  • Viser le temps jusqu'à la première revue sans contrepartie de qualité. Le résultat est le coup de tampon. Montrez le taux de correction après fusion et un échantillon d'approbations sans commentaire à côté de chaque graphique de vitesse.
  • Fixer une limite de taille stricte. Les équipes fractionnent artificiellement le travail pour s'y conformer. Employez la taille comme conversation et enseignez plutôt des techniques de découpage.
  • Traiter zéro commentaire comme un succès. Une approbation non examinée peut refléter de la confiance ou de l'inattention. Échantillonnez ces demandes de fusion et lisez-les ensemble.
  • Compter l'activité des robots comme de la revue. Les commentaires automatisés font paraître l'attente courte. Excluez les robots de l'horloge et des mesures de charge.
  • Ignorer les fuseaux horaires et les calendriers. Le temps d'horloge brut fait paraître lentes les attentes de week-end et entre régions. Employez des heures ouvrées et nommez le calendrier.
  • Laisser la liste des périmées grandir. Les vieilles demandes de fusion accumulent des conflits de fusion et perdent leur contexte. Revoyez la liste chaque semaine et fusionnez, reprenez ou clôturez chaque élément avec un motif.

Modèle de maturité

Dimension 1 Initier 2 Développer 3 Standardiser 4 Gérer 5 Orchestrer
Définition et horloges Le temps de revue est deviné ou rapporté à l'impression Certaines équipes exportent les temps de la plateforme avec leurs propres règles Une définition écrite de chaque horloge, avec des exclusions pour les robots, les brouillons et les calendriers Définitions revues selon un rythme ; changements consignés avec leurs motifs Définitions alignées entre équipes et fournisseurs et révisées quand elles cessent d'éclairer les décisions
Pratique de revue Les revues ont lieu quand quelqu'un le remarque Normes informelles dans certaines équipes Accord de travail écrit sur les demandes, les attentes de réponse et ce qu'une revue couvre Normes ajustées d'après les données ; partage de connaissance et zones à risque suivis Pratique de revue coordonnée entre équipes et fournisseurs, l'automatisation traitant les contrôles courants
Contrepartie de qualité Aucun lien entre revue et défauts Coup d'œil occasionnel aux corrections après fusion Taux de correction après fusion montré à côté de la vitesse de revue Garde-fous revus régulièrement ; approbations échantillonnées lues Preuves de revue reliées à l'assurance des changements et à l'apprentissage des incidents entre services
Usage dans l'amélioration Chiffres inutilisés Montrés à certaines rétrospectives Revus par l'équipe responsable selon une cadence fixe Les écarts mènent à un travail d'amélioration planifié et doté de ressources Les idées d'amélioration circulent des équipes vers la pratique partagée et inversement

Liste de vérification

  • Les horloges du temps jusqu'à la première revue et du temps de cycle de la revue sont écrites, avec début, fin et exclusions.
  • Les robots, les brouillons et les demandes de fusion closes sans fusion sont exclus ou comptés séparément, et les règles sont visibles.
  • Les temps sont rapportés sous forme de médiane et de percentile élevé en heures ouvrées.
  • La taille des demandes de fusion est mesurée avec une liste d'exclusion convenue pour les fichiers générés et tiers.
  • L'équipe a un accord écrit sur la manière dont les revues sont demandées et la rapidité attendue d'une première réponse.
  • La concentration de la charge de revue est rapportée au niveau de l'équipe seulement.
  • Un taux de correction après fusion ou une autre contrepartie de qualité est montré sur le même graphique que la vitesse de revue.
  • Un échantillon d'approbations sans commentaire et très rapides est lu chaque mois.
  • La liste des demandes de fusion périmées est revue chaque semaine.
  • Les données de revue servent en rétrospective et non dans l'évaluation individuelle.
  • Les zones du code n'ayant qu'un seul relecteur qualifié sont listées et ont un plan.

Prompts d'IA

Rédigez des définitions d'horloge pour les métriques de revue.

Je veux définir des métriques de revue pour [team or repository]. Notre
plateforme est [version control platform] et notre flux de travail est
[describe: draft pull requests, required approvals, merge rules, bots in use].
Rédigez des définitions précises du temps jusqu'à la première revue et du temps
de cycle de la revue, en indiquant l'événement qui démarre et arrête chaque
horloge, ce qui est exclu (robots, brouillons, clos sans fusion), comment les
heures ouvrées sont traitées pour [time zones and working calendar] et quels
percentiles rapporter. N'inventez ni valeurs de référence ni fonctions d'outils.
Énumérez vos hypothèses et les questions auxquelles je dois répondre pour
terminer les définitions.

Analysez un export de données de revue.

Voici un export anonymisé de demandes de fusion fusionnées pour [team] sur
[period], avec les colonnes [list columns, for example ready time, first review
time, merge time, lines changed, review rounds, linked fix flag] : [paste data
or summary]. Calculez la médiane et le 85e percentile de chaque mesure de temps
et de la taille, séparez le cycle de revue en attente et en relecture, et
signalez les schémas qui méritent une conversation. Ne classez pas d'individus
et ne comparez pas avec des références extérieures. Énumérez vos hypothèses et
tout problème de qualité des données que vous remarquez.

Trouvez les risques de détournement de nos métriques de revue.

Notre équipe rapporte ces métriques de revue : [list metrics and how each is
calculated]. Les pressions qui s'exercent sur nous sont [for example a release
deadline, a leadership target, a supplier contract]. Pour chaque métrique,
décrivez les façons plausibles de l'améliorer sans améliorer la revue, les
premiers signes de chacune et un garde-fou associé (métrique ou pratique) qui
l'attraperait. N'inventez pas de statistiques. Énumérez vos hypothèses et dites-
moi ce qu'il vous faudrait savoir pour classer les risques.

Préparez une rétrospective sur le flux de revue.

Préparez un ordre du jour de rétrospective de 45 minutes pour [team] sur le flux
de revue. Intrants : temps jusqu'à la première revue [value], temps de cycle de
la revue [value], taille médiane [value], concentration de la charge [value] et
taux de correction après fusion [value], tous étiquetés avec leurs définitions.
Suggérez des questions qui font émerger les causes, une petite expérience que
l'équipe pourrait mener pendant [duration] et le signal de qualité à surveiller
pendant l'expérience. N'inventez ni causes ni objectifs. Énumérez vos
hypothèses et les données que je devrais apporter.

Compétences d'IA

Points clés à retenir

  • L'essentiel du retard de revue est de l'attente ; mesurez donc le temps jusqu'à la première revue et le temps de cycle de la revue sous forme de distributions en heures ouvrées.
  • Les petites demandes de fusion sont relues plus vite et plus soigneusement ; enseignez le découpage plutôt que d'imposer un plafond de taille.
  • Associez chaque mesure de vitesse à une contrepartie de qualité, comme le taux de correction après fusion, et lisez les deux ensemble.
  • Traitez la charge de revue comme une capacité d'équipe et rapportez la concentration au niveau de l'équipe, jamais comme un classement de personnes.
  • Les métriques de revue sont des questions pour une rétrospective, et elles servent l'équipe qui détient le travail.

Références et lectures complémentaires

  1. Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
  2. Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
  3. Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
  4. Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
  5. Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
  6. Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
  7. Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
  8. Wikipedia, Pull request.
  9. Wikipedia, Version control.
  10. Wikipedia, Code review.
  11. Wikipedia, Goodhart's law.
  12. Wikipedia, Continuous integration.
  13. Wikipedia, Trunk-based development.
  14. Wikipedia, Pair programming.
  15. Wikipedia, Static program analysis.