Table of contents

Edit an existing topic using the Contribute link

Brian Lich|Last Updated: 3/15/2017

You can now make suggestions and update existing, public content with a GitHub account and a simple click of a link.


At this time, only the English (en-us) content is available for editing.

To edit a topic

  1. All contributors who are not a Microsoft employee must sign a Microsoft Contribution Licensing Agreement (CLA) before contributing to any Microsoft repositories. If you've already contributed to Microsoft repositories in the past, congratulations! You've already completed this step.

  2. Go to the page on TechNet that you want to update, and then click Contribute.

    GitHub Web, showing the Contribute link

  3. Log into (or sign up for) a GitHub account.

    You must have a GitHub account to get to the page that lets you edit a topic.

  4. Click the Pencil icon (in the red box) to edit the content.

    GitHub Web, showing the Pencil icon in the red box

  5. Using Markdown language, make your changes to the topic. For info about how to edit content using Markdown, see:

  6. Make your suggested change, and then click Preview Changes to make sure it looks correct.

    GitHub Web, showing the Preview Changes tab

  7. When you’re done editing the topic, scroll to the bottom of the page, and then click Propose file change to create a fork in your personal GitHub account.

    GitHub Web, showing the Propose file change button

    The Comparing changes screen appears to see what the changes are between your fork and the original content.

  8. On the Comparing changes screen, you’ll see if there are any problems with the file you’re checking in.

    If there are no problems, you’ll see the message, Able to merge.

    GitHub Web, showing the Comparing changes screen

  9. Click Create pull request.

  10. Enter a title and description to give the approver the appropriate context about what’s in the request.

  11. Scroll to the bottom of the page, making sure that only your changed files are in this pull request. Otherwise, you could overwrite changes from other people.

  12. Click Create pull request again to actually submit the pull request.

    The pull request is sent to the writer of the topic and your edits are reviewed. If your request is accepted, updates are published to one of the following places:

© 2017 Microsoft