Thank you for your interest in our documentation. We appreciate your feedback, edits, additions and help with improving our docs. This page covers the basic steps and guidelines for contributing.
If you want to contribute more than a couple lines and you're not a Microsoft employee, you need to sign a Microsoft Contribution Licensing Agreement (CLA).
To suggest a change to the docs, follow these steps:
- If you're viewing the Docs.microsoft.com 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. If you are already in the GitHub repo, you can just navigate to the source file that you would like to change.
- If you don't already have a GitHub account, click Sign Up in the upper right and create a new account.
- From the GitHub page you would like to change, click the pencil icon.
- Modify the file and use the preview tab to ensure the changes look good.
- When you're done, commit your changes and open a pull request.
After you create the pull request, a member of the Microsoft Edge web docs team will review. If your request is accepted, updates are published to https://docs.microsoft.com/microsoft-edge.
To make substantial changes to an existing article, add or change images, or contribute a new article, we recommend forking the repo into your GitHub account (click the "Fork" button in the top-right corner of the GitHub repo), and then creating a local clone (click the green "Clone or download" button, copy to your clipboard, then in your commandline enter git clone <paste your repo clone link>).
For more info, see Fork a Repo.
If you are unfamiliar with using Git, try the Lynda.com Git Essentials training.
Once you have forked and cloned the repo to your local machine, you can begin authoring with the text editor of your choice. We, of course, recommend Visual Studio Code, a free lightweight open source editor from Microsoft. If you are unfamiliar with markdown authoring, see How to use Markdown in the OPS Guide.
Once you are ready to add your changes to the remote repo so that they will be staged for publishing, enter the following steps in the command line:
git status: This command will show you what files you have changed so that you can confirm that you intended to make those changes.git add -A: This command tells git to add ALL of your changes. If you would prefer to only add the changes you have made to one particular file, instead enter the command:git add <file.md>, where "file.md" represents the name the file containing your changes.git commit -m “Fixed a few typos”: This command tells git to commit the changes that you added in the previous step, along with a short message describing the changes that you made.git push origin <yourbranchname>: This command pushes your changes to the remote repo that you forked on GitHub (the "origin") into the branch that you have specified. Because you have forked the repo to your own GitHub account, you are welcome to do your work in the Develop branch.
When you are happy with your changes and ready to submit a PR:
- Go to your fork of the edge-develop repo: https://github.com/your-github-alias/edge-developer.
- Click the "New pull request" button. (The "base fork:" will be listed as "MicrosoftDocs/edge-developer", the "head fork:" should show your fork of the repo and the branch in which you made your changes.) You can review your changes here as well.
- Click the green "Create pull request" button. You will then be asked to give your Pull Request a title and description, then click the "Create pull request" button once more.
After pushing your contribution to the remote repo, you will be sent an email from Open Publishing Build Service informing whether your contribution built successfully and linking to any error warnings such as broken links, click the links to see your content staged on the site.
Once you have reviewed your contribution on the Microsoft Edge Docs staging site and are confident that you would like your changes to be published live, you must file a Pull Request (PR).
Once your PR is submitted, a member of the Microsoft Edge docs team will review. When it is accepted, you will be able to view your changes on the staging site. These updates will eventually be published live to https://docs.microsoft.com/microsoft-edge.
The Microsoft Edge Docs GitHub repository utilizes two main parent branches: Develop, 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 Develop branch. This branch can be viewed on the staging site and should only contain contributions that are ready to be published live.
For internal Microsoft employees: If you have content to contribute that is confidential or needs to be held back for future release, please email the Web Docs team at webdocs@microsoft.com.
To provide feedback rather than directly modifying actual documentation pages, create an issue.
Be sure to include the topic title and the URL for the page.