dev-community/CONTRIBUTING.md

4.0 KiB

Contributing Guidelines

Contributions are welcome! Please ensure your pull request adheres to the following guidelines.

Awesome Azure

A Note on Awesome Azure

Each repo listed meets at least one of the following requirements:

  • Community-authored repo with 100+ stars
  • Community-vouched repo with < 100 stars
  • Official repo from Azure or Microsoft

100+ stars for community repos is not a strict requirement, it only serves as a guideline for the initial compilation. If you can vouch for the awesomeness of a repo with < 100 stars and you can explain why it should be listed, please submit a pull request.

Pull requests might be left open for a period of time to let the community chime in and vouch for it. An official repo from Azure or Microsoft can be removed if the community wishes. Check out the awesome manifesto.

Pull Requests

  • Search previous suggestions before making a new one, as yours may be a duplicate.
  • Add one link per pull request.
  • Add the link:
    • [name](http://example.com/) - A short description ends with a period.
    • Keep descriptions concise.
    • Maintain alphabetical ordering where applicable.
  • Add a section if needed.
    • Add the section description.
    • Add the section title to the Index.
  • You generally do not need to mention Azure in the description as it's implied.
  • Check your spelling and grammar.
  • Remove any trailing whitespace.
  • Send a pull request with the reason why the addition is awesome.
  • Use the following format for your pull request title:
    • Add user/repo - Short repo description
  • Improvements to the existing sections are welcome.
  • If you think a listed link is not awesome, feel free to submit an issue or pull request to begin the discussion.

Thank you for your suggestions!

Trainings and Events


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. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.

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

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


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.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.