Overview of editing documentation on Microsoft Learn

Thank you for your interest in editing documentation on Microsoft Learn! Your contributions help us ensure our documentation is well written, up to date, and accurate. The information on this page will help you decide which method of contribution is best for you.

Before you get started, make sure you're signed in to your GitHub account. If you don't have one, navigate to https://github.com/join for a fast and free sign-up process.

Process overview

The process flow below shows the basic steps involved in getting started. Notice that some items are one-time steps, while others occur every time you start a new contribution.

Process flow map showing the basic workflow for getting started with the contribution process.

The image starts with a decision point of Is this your first time contributing? If yes, the next step is to set up your GitHub account. If no, the next step is another decision point of Is your change minor? If yes, the next step is to edit within the browser. If no, the next steps involve installing authoring tools, forking and cloning the repo, making changes, opening a pull request, and reviewing and signing off on your pull request.

How large is your change?

If you're making minor changes to an article, follow the steps in Edit documentation in the browser. All you need is a GitHub account; you don't need to download and install any tools. Examples of minor changes are fixing typos, basic revisions to one or more articles, adding a section to an article, or updating links.

If you're making more substantial or frequent changes, we recommend installing Git and Markdown tools and forking and cloning the repo. Frequent contributors typically have ongoing (long-running) changes that go through multiple build-validation-staging cycles or span multiple days before they sign off on their pull request.