Maintenance assistée

Lire le diff

L'onglet Diff montre, fichier par fichier, ce que le correctif proposé change. Il vous permet de relire la proposition avant ou après sa publication en PR brouillon.

Qui peut le faire : tout membre du projet (Lecteur compris) et l'Administrateur.

Afficher le diff#

  1. Ouvrez une exécution dont le badge indique Correctif prêt.
  2. Cliquez sur l'onglet Diff.
  3. Dans la liste Fichier modifié, choisissez le fichier à examiner. Le premier fichier est affiché par défaut.

Tant que le contenu se charge, la page affiche « Chargement du diff… ».

Lire la comparaison#

La carte Diff proposé présente deux colonnes :

  • Avant · à partir de la ligne N : les lignes d'origine remplacées, préfixées par - ;
  • Après · à partir de la ligne N : les lignes proposées, préfixées par +.

L'écran montre le bloc compris entre la première et la dernière ligne modifiées du fichier. Les lignes identiques avant et après ce bloc ne sont pas répétées. Le numéro N indique la ligne où le bloc commence.

La vue de repli#

Pour afficher la colonne Avant, la plateforme relit le fichier d'origine sur GitHub, au commit de base de l'exécution. Elle ne l'affiche que si son empreinte correspond exactement au fichier lu par les agents et qu'il ne contient aucun marqueur de secret.

Si cette lecture échoue (accès GitHub retiré, dépôt indisponible, empreinte différente), la page affiche l'encadré Version d'origine indisponible : « Le fichier proposé reste consultable. ». Le contenu complet du fichier proposé s'affiche alors, sans comparaison.

Revue de code et tests : deux choses différentes#

La revue par l'agent Revue porte sur le code proposé. Elle ne remplace pas l'exécution des tests du dépôt : 101Maintain n'exécute ni les tests, ni le build, ni l'application. La carte Proposition de l'onglet Agents et besoin le rappelle par la mention Tests du dépôt non exécutés., et le corps de la PR brouillon l'indique aussi.

Les tests et la CI configurés sur le dépôt s'exécutent sur GitHub une fois la PR ouverte. Leur résultat apparaît dans l'onglet Suivi, ligne CI GitHub.

Messages possibles#

MessageSignification
Aucun correctif proposéL'exécution n'a pas produit de correctif. « Le diff est disponible après préparation du correctif. »
Diff indisponibleLe fichier demandé n'appartient pas à la proposition, ou le service est momentanément indisponible. Rechargez la page.
Version d'origine indisponibleVue de repli, voir ci-dessus.

Une proposition modifie au plus 8 fichiers, uniquement parmi ceux que les agents ont lus. Elle ne crée ni ne supprime de fichier, et conserve le mode de chaque fichier.

Pour continuer#

Notification avant publication (effet)