Exercice - contribuer à un article de documentation Microsoft Learn

  • 4 minutes

Examinons le flux de travail de contribution dans la pratique. Dans cet exercice, vous apportez une petite modification à un article de documentation open source sur Microsoft Learn. Ensuite, vous proposez vos modifications en ouvrant une pull request.

Modifier l’article

  1. Commencez par vous connecter à votre compte GitHub.

  2. Dans un onglet de navigateur, accédez à learn.microsoft.com/contribute/content.

  3. En haut de l’article, sélectionnez l’icône de crayon Modifier.

    Capture d’écran montrant l’article Contribuer ouvert et l’icône de crayon Modifier mise en valeur.

  4. Sélectionnez l’icône de crayon pour Dupliquer (fork) ce dépôt et le modifier dans votre fourche ou Modifier ce fichier dans votre fourche de ce projet.

    Capture d’écran du fichier source de l’article Contribuer ouvert dans un navigateur et de l’icône Modifier mise en surbrillance.

  5. Si GitHub vous invite à fourcher le référentiel sur la page suivante, sélectionnez Fourcher le référentiel.

  6. Le volet Modifier le fichier s’ouvre . Vous devez ajouter une nouvelle phrase au début de cet article. Au début du deuxième paragraphe, ajoutez la phrase suivante : Microsoft Learn héberge toute la documentation relative aux produits et technologies Microsoft.

    Capture d’écran du fichier Contribuer modifié avec une nouvelle phrase et du bouton Commiter les modifications mis en surbrillance.

Ouvrir une demande de tirage (pull request)

  1. Affichez un aperçu de vos modifications en sélectionnant l’onglet Aperçu .

  2. Une fois vos modifications finalisées, recherchez et sélectionnez Valider les modifications.

  3. Dans le champ message de validation, tapez « TEST contribution ».

    Capture d’écran du champ Message de commit renseigné avec la contribution TEST.

  4. Sélectionnez Proposer des modifications.

  5. Dans la page Comparaison des modifications , vérifiez que la base indique main. Cela signifie que vos modifications seront extraites dans la branche principale du référentiel en direct.

    Capture d’écran de la page pour vérifier que la Base est Main, ce qui signifie que les modifications seront fusionnées vers la branche principale.

    Remarque

    Si vous ne voyez pas les options base repository et head repository de cette page, sélectionnez Comparer entre les fourches. Vous voyez ainsi les options de comparaison nécessaires pour cette étape.

  6. Cliquez sur le bouton Créer une pull request.

  7. Cela vous mène à la page Ouvrir une pull request où vous pouvez prévisualiser votre PR.

  8. Confirmez votre demande de tirage et sélectionnez Créer une demande de tirage pour ouvrir la demande de tirage.

    Capture d’écran de la demande de tirage ouverte.

Remarque

Étant donné qu’il s’agit d’un exercice pratique, vos modifications ne sont pas fusionnées sur le site web en direct.

Félicitations ! Vous venez de créer une demande de tirage. Elle n’est pas encore envoyée, mais vous avez terminé la première étape majeure de la contribution. Laissez l'onglet PR ouvert dans votre navigateur. Vous y reviendrez dans l’exercice suivant.