This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

You've found one of the GitHub repositories that houses the source for content published to https://docs.microsoft.com, home of all technical content for Microsoft's Cloud and Enterprise Division.

We want and encourage contributions from our community (users, customers, partners, friends on other planets) and Microsoft employees to improve your documentation. Here are some tips:

• Create a GitHub account: Sign up is free at GitHub.com.

• Use your browser: There are two options:

  Option 1: Edit directly from docs.microsoft.com

  1. Go to the topic, such as https://docs.microsoft.com/intune/troubleshoot-policies-in-microsoft-intune.
  2. Select Edit (top right). This shows the markdown file in the GitHub repository.
  3. Select the pencil icon. When you hover over the pencil icon, you'll see the Edit this file tooltip.
  4. Make your changes, and then commit your changes.
  5. Create the pull request.

  Option 2: Find the article in this repository, and update

  1. Most topics are in https://github.com/MicrosoftDocs/IntuneDocs/tree/master/intune. In this folder, search for the topic name, such as troubleshoot-policies-in-microsoft-intune.
  2. Select the link, and click the pencil icon. When you hover over the pencil icon, you'll see the Edit this file tooltip.
  3. Make your changes, and then commit your changes.
  4. Create the pull request.

  When you make an update, you may be prompted to sign a license agreement. This is a one-time task. So any future updates by your GitHub username won't need to sign again.

  The value in the author metadata (at the top of every topic) lists the GitHub author. In the troubleshoot-policies-in-microsoft-intune example, you'll see MandiOhlinger. In your pull request, you can also mention (@authorValue) the author if you like.

• MSFT Employees: After you create a GitHub account, link it to your Microsoft email address. When your account is linked, you don't have to sign a license agreement to make an update. Steps:

  1. On a device with corpnet, go to GitHub account setup. If you're not on corpnet, this link returns a 404.

  Creating a GitHub account, and linking to your Microsoft account is a one-time thing. When your account is linked, you don't have to sign a license agreement to make an update.

  2. In your browser, go to the article, and select Edit. Switch to the private repo (IntuneDocs-pr):
     From: https://github.com/MicrosoftDocs/IntuneDocs/...
     To: https://github.com/MicrosoftDocs/IntuneDocs-pr/...

  3. Select the pencil icon, and make your changes.

All the articles in this repository use GitHub-flavored markdown. Here's a list of resources to get started:

• Markdown basics
• Printable markdown cheatsheet