Demander une modification limitée
Votre site a maintenant deux fichiers. Faites-le évoluer une nouvelle fois, avec la même rigueur qu'au guide précédent.
mon-premier-site contient désormais index.html et style.css, construits au guide précédent. Ce guide vous fait pratiquer une nouvelle modification, plus petite cette fois, mais sur un projet qui a grandi : la vérification demande donc un peu plus d'attention qu'au tout premier diff du guide 8.
Pourquoi rester sur une petite portée, même avec un projet qui grandit
Plus un projet contient de fichiers, plus une demande large risque de produire un ensemble de changements difficile à relire d'un coup. La discipline apprise sur un projet à un seul fichier devient encore plus utile à mesure que le projet grandit, pas moins : c'est précisément ce que ce guide vous fait pratiquer.
Demander un seul ajout ciblé
Ouvrez le panneau Agent et formulez une demande qui ne touche qu'un seul aspect précis.
« Dans @index.html, ajoute un second paragraphe sous celui qui existe déjà, qui invite le visiteur à revenir bientôt. Ne modifie ni le titre, ni le premier paragraphe, ni style.css. »
La limite explicite sur style.css, bien qu'il ne soit pas directement concerné par la demande, n'est pas superflue : elle réduit le risque qu'une reformulation ou un ajustement de mise en forme s'y glisse sans que vous l'ayez explicitement demandé.
Revoir le diff, fichier par fichier
Sur cette tâche, vous ne devez voir apparaître qu'un seul fichier dans la revue de changements, index.html. Si style.css apparaît malgré tout dans la liste des fichiers modifiés, c'est un signal à traiter exactement comme au guide 8 : n'acceptez pas ce fichier sans comprendre pourquoi il a été touché.
Vérifier que l'existant n'a pas bougé
Après acceptation, ouvrez index.html et vérifiez trois choses : le titre est identique à avant, le premier paragraphe est identique à avant, et le nouveau paragraphe apparaît bien en dessous, avec le texte attendu. Ouvrez aussi style.css une dernière fois : il doit être resté strictement identique à sa version du guide précédent.
Tester le rendu final
Rechargez index.html dans votre navigateur : le nouveau paragraphe doit apparaître sous les éléments existants, avec le même style de fond et de couleur de titre défini dans style.css, puisque celui-ci n'a pas été modifié.
Sur un projet à plusieurs fichiers, vérifiez toujours la liste des fichiers effectivement modifiés dans le diff avant même de lire le détail de chacun. C'est la vérification la plus rapide, et souvent la plus révélatrice si quelque chose ne correspond pas à votre demande.
Vérifiez que vous avez compris
Votre demande portait uniquement sur l'ajout d'un second paragraphe dans index.html. Le diff proposé montre pourtant une reformulation légère du premier paragraphe, en plus de l'ajout demandé. Devez-vous accepter l'ensemble tel quel ?
Non, pas nécessairement. Vous pouvez accepter uniquement l'ajout demandé et refuser la reformulation non sollicitée, ou demander à l'Agent de ne proposer que l'ajout, sans toucher au texte existant. Un changement supplémentaire, même mineur et bien intentionné, reste un changement que vous n'aviez pas explicitement autorisé.