azure-docs
Open source documentation of Microsoft Azure
The open-source Markdown source files behind Microsoft Azure's official documentation at learn.microsoft.com, open for community contributions via fork-and-pull-request.
This repository holds the open-source documentation for Microsoft Azure, the cloud computing platform. The actual rendered documentation lives at learn.microsoft.com/azure, and this repository is the source files behind those pages. It is primarily composed of Markdown files that are built into the web documentation that Azure users and developers read when looking up how to use Azure services.
The repository is public specifically to allow community contributions. Anyone with a GitHub account can propose changes to the documentation: fixing errors, clarifying explanations, updating outdated instructions, or reporting issues when something is wrong. The README points to a contributing guide that explains the process and the tools needed to author and submit changes.
Contributing requires a GitHub account and a set of content authoring tools whose installation instructions are linked from the contributor guide rather than described in the README itself. The general process follows the standard open-source contribution model: fork the repository, make changes in a branch, and open a pull request.
The repository is governed by a Microsoft Open Source Code of Conduct and uses separate license files for documentation content and any code samples included in the docs. The README does not describe the structure of the repository or how to find specific service documentation.
Because this is a documentation repository rather than a software project, there is nothing to install or run. Its value is as the editable source for one of the largest cloud platform documentation sets available, with contributions from Microsoft employees and the broader Azure community.
Where it fits
- Fix an error or outdated instruction in Azure's official documentation by forking the repo and submitting a pull request.
- Report a documentation problem for any Azure service by opening a GitHub Issue in this repository.
- Contribute a new example or clarification to Azure documentation following the contributing guide.