Contributing

December 19, 2025 · View on GitHub

We are very happy to see you here! This project welcomes contributions and suggestions from everyone, regardless of ones skills and experience. In this document you will find guidelines on how to contribute to this project.

Issues

The easiest way to contribute is to participate in discussion on GitHub issues. Other way to participate is to create an issue or by submitting pull request with code changes.

Creating Issues

If you find a bug in the project, or have an idea for a feature, you can create an issue. But before you do, please search the existing issues to see if someone else has already beat you to it. If you find a similar issue, please upvote it. Consider adding your experience to the discussion. For bugs also consider adding your use case as a comment to the issue. If you can't find an issue that matches what you've found, feel free to create a new one.

Security issue

Please check Security for more information.

Pull requests

If you want to contribute to the project, you can create a pull request. Before you spend a lot of time on a pull request, it is recommended to discuss the problem and solution in an issue first. This will greatly increase alignment of your PR with the project goals and reduce the chance of wasted effort.

For more information on how to set up the development environment, see Development environment setup.

Implementation guides

Add new policy guide

License

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.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., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories 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.