Edit

Share via


Contributing to the Microsoft Collaborate documentation

Thank you for your interest in our documentation. We appreciate your feedback, edits, additions and help with improving our content. This page covers the basic steps and guidelines for contributing.

Important

All repositories that publish to Microsoft Learn have adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any questions or comments.

Minor corrections or clarifications to documentation and code examples in public repositories are covered by the learn.microsoft.com Terms of Use. New or significant changes will generate a comment in the pull request asking you to submit an online Contribution License Agreement (CLA) if you are not an employee of Microsoft. We need you to complete the online form before we can accept your pull request.

How to make a change

To suggest a change, follow these steps: Screenshots
1. If you're viewing a Microsoft Learn page, click the Edit button in the upper right of the page. You will be redirected to the corresponding Markdown source file in the GitHub repository. Edit Button
2. If you don't already have a GitHub account, click Sign Up in the upper right and create a new account. Signup button
3. On the corresponding GitHub page that opens, click Edit (the pencil icon). Pencil button
4. In the Edit file pane, use Markdown language to make changes to the content. (How to write markdown.) Edit File
5. Click Preview changes to verify the formatting looks as expected. Preview changes
6. When you're done, scroll to the bottom of the page and click "Propose file change", you will be presented with a "Comparing changes" page, allowing you to verify your changes. Then click the "Create pull request" button to submit your changes. At this point you are finished! Propose a change

After you submit changes (via a pull request), they will be reviewed by a member of the documentation team. If your request is accepted, updates are published to the Microsoft Collaborate documentation.

*For internal review only, you can see your changes on the staging site.

Working with Branches

The MS Collaborate GitHub repository utilizes two main parent branches: main, this content can be reviewed on the staging site, and live, for content appearing on the live site.

When making contributions, please submit your Pull Request (PR) to the main branch. This branch can be viewed on the staging site and should only contain contributions that are ready to be published live. You may also create and submit a branch with your own unique branch name which can be selected and viewed in the staging site. (The Live branch is only allowed for use by the content administrators.)

Using issues to provide feedback on MS Collaborate documentation

To provide feedback, or point out a problem, rather than directly modifying actual documentation pages, create an issue and the content owners will do their best to address the issue in a timely fashion.

Be sure to include the topic title and the URL if you are creating an issue regarding a specific page.

Thank you for supporting this content!