Welcome to the docs.microsoft.com (Docs) Contributor Guide!
About this guide
Here you'll find all of the information you need to contribute to Docs articles, by using the Microsoft Open Publishing Services (OPS) platform and the supporting tools and processes.
The table of contents to your left is designed to help you get started and be productive contributing to Microsoft Docs. The introductory articles provide a quick start for the tasks that are common to any contribution activity. Later articles are specific to different tasks, and you should focus on the section that describes the activity that interests you. Many of the articles can also serve as reference content, which you might want to save as a favorite/bookmark in your browser. Also note that there are several links to other sites, which will take you to pages that are off the docs.microsoft.com domain and outside this guide.
There are several ways to contribute to docs:
- You can create issues to recommend new articles, or improve existing articles.
- You can quickly edit articles to make small changes in the GitHub online editor.
- You can review drafts of new articles to ensure quality and technical accuracy.
- You can create new articles for topics when you want to help drive the content story.
- You can update or create samples to improve the code samples that reinforce important concepts.
All our public repositories are hosted on GitHub and written in Markdown. You'll need the following to contribute:
- If you don't already have one, create a GitHub account.
- Docs articles are written in a markup language called Markdown. You should have a basic understanding of Markdown syntax.
Quick start to propose an article change
If you don't have time to digest the entire guide or install tools, and you just need to make a minor contribution, here are the essentials. Use the web editing workflow to submit your contribution via a GitHub pull request. You'll be editing the content and submitting the PR in the browser.
Additional ways to contribute to docs.microsoft.com content
You can learn more about the different tasks in our article on how to contribute.
If you have suggestions for contributions, or you have questions about this guide, please use the Livefyre comments section on this page.