Review documentation using GitHub Issues
One of the most useful ways to contribute to Microsoft Learn is to give feedback directly on a documentation article. Using the feedback link on the page, you can provide edits, suggestions, questions, or other insights as they come up in your browsing. Since most Microsoft Learn documentation content is stored in GitHub repositories, you can provide your feedback using a GitHub process called submitting a GitHub Issue.
An Issue in GitHub is a tool that enables technology users, engineers, and other Microsoft Learn visitors to share and track feedback on a specific article. You fill out a form to document your feedback and post it to the source article’s repository in GitHub, where an author or owner will be notified. Anyone who visits the GitHub repository can see Issues. They serve as a helpful way to collect and store valuable feedback, like reporting bugs, feature requests, or notes.
Why review content in GitHub?
Providing content reviews on GitHub is a direct way to contribute to a topic you’re passionate or knowledgeable about. This means you can add your ideas as you’re exploring a topic on Microsoft documentation. Contributing your insights to the pool of knowledge helps improve Microsoft product experiences for millions of other users. Your feedback advances content for other Microsoft Learn visitors who rely on Microsoft products and their supporting content.
In most cases, submitting GitHub feedback enables you to send your ideas to the team in charge of the product’s content set. This collaboration pathway between content teams and product users allows feedback to be shared and discussed directly in GitHub.
Contributing to documentation content can provide professional benefits to you as well. GitHub is a well-known platform where technical contributions can be made and tracked. Each time you contribute to a project on GitHub, it’s reflected in your GitHub profile. Over time, you can build a record of your contributions to add to your technical portfolio.
How to give feedback on content
Recall that many documentation articles on Microsoft Learn are stored in GitHub repositories. Many GitHub repositories have GitHub issues enabled. When enabled, you can find the option to submit feedback for this page at the bottom of an article on learn.microsoft.com.
Here’s how to submit an issue in GitHub from a Microsoft Learn article:
Navigate to the Microsoft Learn documentation article on which you’d like to give feedback.
At the bottom of the article, find the heading labeled Feedback. Next to the question Was this page helpful?, there are buttons for Yes and No. Select a button to indicate whether the article was helpful. This opens a form where you can fill out your comments.
Select the reason for your feedback.
In the following text box, describe your feedback and provide any necessary context.
When you’re finished, select Submit.
The article’s author or other content owners are notified when you submit your Issue.