Exercice - contribuer à un article de documentation Microsoft Learn

  • 4 minutes

Nous allons pratiquer le flux de travail de contribution. 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 demande de tirage (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 de l’article Contribuer ouvert et de l’icône de crayon Modifier mise en surbrillance.

  4. Sélectionnez l’icône de crayon pour fourcher ce référentiel et modifiez-la dans votre fork ou modifiez 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 toutes les documentations relatives 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

  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 Valider le message , tapez « contribution TEST ».

    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 les options de cette page, sélectionnez Comparer entre les fourches. Cela affiche les options de comparaison nécessaires pour cette étape.

  6. Cliquez sur le bouton Créer une requête de tirage.

  7. Vous accédez à la page Ouvrir une requête de tirage (pull request) dans laquelle vous pouvez afficher un aperçu de votre demande de tirage.

  8. Confirmez votre requête de tirage et sélectionnez Créer une requête 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 seront pas fusionnées vers le site web en direct.

Félicitations pour la création de votre demande de tirage ! Il n’est pas encore soumis, mais vous avez terminé la première étape majeure de la contribution. Laissez la page ouverte dans votre navigateur. Vous y reviendrez dans l’exercice suivant.