diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b909c0a74e..4eea0f752a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -13,12 +13,29 @@ You've already completed this step. We've tried to make editing an existing file as simple as possible. -- If you're already in the repo, just navigate to the file you want to make the edits to and click the **Edit** button. -- Alternatively, if you're viewing a TechNet page in your browser, click the **Contribute** button on the top right of the page. You will be redirected to the relevant source file in the repo, where you can click the **Edit** button. - -When you're done, submit a pull request back to the master branch of the official repository. +**To edit a topic** +1. Go to the page on TechNet that you want to update, and then click **Contribute**. + + ![GitHub Web, showing the Contribute link](images/contribute-link.png) + +2. Click the **Pencil** icon (in the red box) to edit the content. + + ![GitHub Web, showing the Pencil icon in the red box](images/pencil-icon.png) + +3. Using markdown language, make your changes to the topic. For info about how to edit content using markdown, see http://aka.ms/windows-op-guide. + +4. Make your suggested change, and then click **Preview Changes** to make sure it looks correct. + + ![GitHub Web, showing the Preview Changes tab](images/preview-changes.png) + +5. 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](images/propose-file-change.png) + +The Comparing changes screen appears to see what the changes are between your fork and the original content. +6. 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. -After you create the pull request, a member of the writing team will review your changes. If your request is accepted, updates are published to one of the following places: diff --git a/images/compare-changes.png b/images/compare-changes.png new file mode 100644 index 0000000000..0d86db70f5 Binary files /dev/null and b/images/compare-changes.png differ diff --git a/images/contribute-link.png b/images/contribute-link.png new file mode 100644 index 0000000000..6b17e6dd56 Binary files /dev/null and b/images/contribute-link.png differ diff --git a/images/pencil-icon.png b/images/pencil-icon.png new file mode 100644 index 0000000000..82fe7852dd Binary files /dev/null and b/images/pencil-icon.png differ diff --git a/images/preview-changes.png b/images/preview-changes.png new file mode 100644 index 0000000000..f98b2c6443 Binary files /dev/null and b/images/preview-changes.png differ diff --git a/images/propose-file-change.png b/images/propose-file-change.png new file mode 100644 index 0000000000..aedbc07b16 Binary files /dev/null and b/images/propose-file-change.png differ