Several of Microsoft's documentation sets are open source and hosted on GitHub. While not all documentation sets are completely open source, many have public-facing repositories where you can suggest changes via pull requests (PRs). This open-source approach streamlines and improves communication between product engineers, content teams, and customers.

Quick edits facilitate the process to report and fix small errors and omissions in documentation. Despite all efforts, small grammar and spelling errorsdo make their way into our published documents. We appreciate your help in identifying and fixing these issues!

We use PRs for all changes, even for contributors who have write access. Most repositories protect the default branch, so updates must be submitted as PRs.

Prerequisite

• Create a GitHub account, if you don't have one.

Edit a document in the browser

1. Navigate to the documentation you want to edit.Some docs pages allow you to edit content directly in the browser. If so, you'll see anEdit pencil icon like the one shown below. Choosing theEdit pencil icon takes you to the source file on GitHub.

   

   If theEdit pencil icon isn't present, it means the content isn't open to public contributions. Some pages are generated (for example, from inline documentation in code) and must be edited in the project they belong to.

2. Select theEdit pencil icon at the top of the GitHub file page. If theEdit pencil icon is unavailable (appears dimmed) or doesn't display, you need to log in to your GitHub account.

   

   At the top of the article is the article's metadata. Metadata is applied to articles for reporting, discoverability via search, and driving aspects of the site experience. If you're making minor updates to a published article, you probably won't need to change the metadata.

3. If it's your first time working in this repository, you'll be prompted to fork the repo before you propose changes. SelectFork this repository to continue.

4. Edit the file in the web editor. Choose thePreview tab on the toolbar to check the formatting of your changes.

5. When you're finished editing, select theCommit changes orPropose changes button, usually at the top-right of the screen.

6. Enter a commit message. The commit message becomes the title of your PR and should be a brief summary of your changes (for example, "Fix spelling and grammar errors"). Optionally, add anExtended description to give more details about your changes. SelectPropose changes:

   

7. Now that you've proposed and committed your changes, you need to ask the owners of the repository to "pull" your changes into their repository. This is done using apull request (PR). When you selectPropose changes, you'll see a page like this:

   

   Your PR proposes changes from your fork and branch (represented by the two items on the right side of the arrow) into the documentation repo's main fork andmain branch (represented by the two items on the left side of the arrow).

   Review your changes, and then selectCreate pull request.

8. On theOpen a pull request page, preview your PR. You can change the title or description fields if needed. When you're ready, selectCreate pull request. This action opens your PR and alerts the article owner that you've proposed a change.

9. That's it! Content team members will review your PR and merge it when it's approved. You may get feedback requesting changes. For more details on processing your PR, seeProcess a pull request.

Limitations

• Most localized (i.e., translated) content doesn't offer the ability to edit through GitHub. However, you can provide feedback on translation quality by selecting the Feedback (thumbs) button at the top of the page and then choosing theTranslation quality reason. You can also leave more specific feedback on localized content by using theProvide Feedback form.
• The in-browser editing experience works best for minor and infrequent changes. If you make large contributions or use advanced Git features (such as branch management or advanced merge conflict resolution), we recommend that youfork the repo and work locally.