Git Product home page Git Product logo

microsoft-365-docs's Introduction

ms.date
9/15/2023

Overview

Learn how to contribute

Anyone who is interested can contribute to the articles. When you contribute, your work goes into the content set after it's been reviewed and merged. It's then published to Microsoft Learn, and you're listed as a contributor at: https://github.com/MicrosoftDocs/microsoft-365-docs/graphs/contributors.

Quickly update an article using GitHub.com

Contributors who make infrequent or small updates can edit the file directly on GitHub.com without installing any software. This article shows you how. This two-minute video also covers how to contribute.

Tip

To edit an article, you need to get to it on the GitHub.com backend. If you're already on the GitHub.com page of the article, you're starting at step 4.

Your permissions in the repo determine what you see in step 5 and later. People with no special privileges see the steps as described. People with permissions to approve their own pull requests see a similar experience with different button and page titles (for example, Commit changes instead of Propose changes), extra options for creating a new branch, and fewer confirmation pages. The point is: click any green buttons that are presented to you until there are no more.

  1. Verify that you're signed in to GitHub.com with your GitHub account.

  2. On learn.microsoft.com, find the article that you want to update.

  3. Above the title of the article, select Edit this document icon. Edit this document.

    Screenshot of how to edit this document button on a learn.microsoft.com article.

  4. The corresponding article file opens on GitHub. Select Edit this file icon. Edit this file.

    Screenshot of how to edit this document button on a GitHub article file.

  5. The article file opens in a line-numbered editor page where you can make updates.

    Articles on learn.microsoft.com are formatted using the Markdown language. For help on using Markdown, see Mastering Markdown..

    Select Preview to view your changes as you go. Select Edit to go back to making updates.

    When you're finished making changes, select the green Commit changes button.

    Screenshot of how to select the green Commit changes button on the article editor page.

  6. In the Propose changes dialog that opens, review and/or enter the following values:

    • Commit message: This value is required. You can accept the default value ("Update <filename>") or you can change it.
    • Extended description: This value is optional. For example:
      • An explanation of the changes.
      • @ include the GitHub alias of someone to review and merge your changes.

    When you're finished on the Propose changes dialog, select the green Propose changes button.

    Screenshot of how to select the green Propose changes button in the Propose changes dialog.

  7. On the Comparing changes page that opens, select the green Create pull request button.

    Screenshot of how to select the green Create pull request button on the Comparing changes page.

  8. On the Open a pull request page that opens, review the title and comments, and then select the green Create pull request button.

    Screenshot of how to select the green Create pull request button on the Open a pull request page.

  9. That's it. There's nothing more for you to do.

    The article owner (identified in metadata) is notified about the changes to the article. Eventually, the article owner or another party will review, possibly edit, and approve your changes. After your pull request is merged, the article is updated on learn.microsoft.com.

Microsoft Open Source Code of Conduct

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 questions or comments.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot automatically determines whether you need to provide a CLA and decorate the PR appropriately (for example, label, comment). Follow the instructions provided by the bot. You only need to do this step once across all repos using our CLA.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries/regions.

The licenses for this project don't grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at https://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found at https://privacy.microsoft.com/

Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.

microsoft-365-docs's People

Contributors

denisebmsft avatar chrisda avatar chuckedmonson avatar robmazz avatar chrfox avatar garycentric avatar markjjo avatar mjcaparas avatar siosulli avatar joedavies-msft avatar msbemba avatar v-dihans avatar kwekuako avatar chvukosw avatar dansimp avatar tiburd avatar cmcatee-msft avatar v-stsavell avatar mikeplumleymsft avatar jaimeo avatar sirkkuw avatar msfttracyp avatar dstrome avatar skjerland avatar kelleyvice-msft avatar kccross avatar cabailey avatar stacyrch140 avatar lhcole avatar brendacarter avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.