Passer en revue la documentation en utilisant Problèmes GitHub
L’un des moyens les plus utiles pour contribuer à Microsoft Learn consiste à fournir des commentaires directement sur un article de la documentation. À l’aide du lien de commentaires fourni sur la page, vous pouvez apporter des modifications, des suggestions, des questions ou d’autres insights à mesure que des articles apparaissent dans votre navigation. Étant donné que la plupart du contenu de la documentation Microsoft Learn est stocké dans des référentiels GitHub, vous pouvez fournir vos commentaires en tirant parti du processus GitHub appelé envoi d’un problème GitHub.
Un problème dans GitHub correspond à un outil qui permet aux utilisateurs technologiques, aux ingénieurs et à d’autres visiteurs de Microsoft Learn de partager et de suivre des commentaires sur un article spécifique. Vous remplissez un formulaire pour documenter vos commentaires et les publier dans le référentiel de l’article source dans GitHub, où un auteur ou un propriétaire est averti. Toute personne visitant le référentiel GitHub peut voir les problèmes. Ils constituent un moyen utile pour collecter et stocker des commentaires utiles, tels que le signalement de bogues, les demandes de fonctionnalités ou les notes.
Pourquoi évaluer le contenu dans GitHub ?
La fourniture de révisions de contenu sur GitHub est une façon directe de contribuer à une rubrique qui vous intéresse ou sur laquelle vous avez des connaissances. Cela signifie que vous pouvez ajouter vos idées lorsque vous découvrez une rubrique sur la documentation de Microsoft. La contribution de vos insights à la base de connaissances permet d’améliorer les expériences des produits Microsoft pour des millions d’utilisateurs. Vos commentaires font avancer le contenu pour d’autres visiteurs de Microsoft Learn qui ont recours à des produits Microsoft et à leur contenu associé.
Dans la plupart des cas, l’envoi de commentaires GitHub vous permet d’envoyer des idées à l’équipe chargée de l’ensemble du contenu du produit. Ce parcours de collaboration entre des équipes dédiées au contenu et des utilisateurs de produits permet de partager des commentaires et de discuter directement dans GitHub.
La contribution au contenu de la documentation peut également vous offrir des avantages professionnels. GitHub est une plateforme bien connue où des contributions techniques peuvent être effectuées et suivies. Chacune de vos contributions à un projet sur GitHub est reflétée dans votre profil GitHub. Au fil du temps, vous pouvez créer un enregistrement de vos contributions pour les ajouter à votre portefeuille technique.
Procédure de soumission des commentaires sur le contenu
Rappelez-vous que de nombreux articles de la documentation sur Microsoft Learn sont stockés dans des référentiels GitHub. Des problèmes GitHub activés se trouvent dans de nombreux référentiels GitHub. Lorsque cette option est activée, vous trouverez l’option permettant d’envoyer des commentaires pour cette page en bas d’un article sur learn.microsoft.com.
Voici la procédure pour envoyer un problème dans GitHub à partir d’un article Microsoft Learn :
Accédez à l’article de la documentation Microsoft Learn sur lequel vous souhaitez envoyer des commentaires.
En bas de l’article, recherchez le titre intitulé Commentaires. En regard de la question Est-ce que cette page est utile ?, il existe des boutons pour Oui et Non. Sélectionnez un bouton pour indiquer si l’article était utile. Cela ouvre un formulaire dans lequel vous pouvez remplir vos commentaires.
Sélectionnez la raison de vos commentaires.
Dans la zone de texte suivante, décrivez vos commentaires et fournissez tout contexte nécessaire.
Lorsque vous avez terminé, sélectionnez Envoyer.
L’auteur de l’article ou d’autres propriétaires de contenu sont avertis lorsque vous envoyez votre problème.