README
Thank you for your interest in Office developer documentation!
Ways to contribute
You can contribute to Office developer documentation in a few different ways:
- Contribute to articles via the public Office developer docs repo*
- Report documentation bugs via GitHub Issues
- Add documentation requests to the Office/SharePoint developer UserVoice
*We're only taking documentation contributions for the OpenXML Conceptual content at this time
Repository organization
The content in the office-content repository is grouped first by article language, then by topic. The README.md file at the root of each topic directory specifies the structure of the articles within the topic.
Article within each topic are named by MSDN GUID rather than title name. This is a side effect of our document management process and cannot be changed at this time. We highly recommend using the table of contents within each topic directory (see links below) to navigate to the files you wish to view or edit.
Articles in this repository
Open XML
Before we can accept your pull request
Minor corrections
Minor corrections or clarifications you submit for documentation and code examples in this repository do not require a Contribution License Agreement (CLA). Submissions are taken in the form of pull requests. We will do our best to review pull requests within ten business days.
Larger submissions
If you submit new or significant changes to documentation and code examples, you need to send a signed Contribution License Agreement (CLA) before we can accept your pull request if you are in one of these groups:
- Members of the Microsoft Open Technologies group.
- Contributors who don't work for Microsoft.
As a community member, you must sign the Contribution License Agreement (CLA) before you can contribute large submissions to this project, but you only need complete and submit the documentation once. Please carefully review the document; you may also need to have your employer sign the document.
Signing the Contribution License Agreement (CLA) does not grant you rights to commit to the main repository, but it does mean that the Office Developer and Content Publishing teams will be able to review and consider your contributions and you will get credit if we do.
You can download the Contribution License Agreement (CLA) here. Please fill out the form and email it to [email protected].
Once we receive and process your CLA, we will do our best to review your pull request(s) within ten business days.
Guidance for contributors
For more guidance on contributing to Office developer documentation, see CONTRIBUTING.md in this repo.
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.