Contributing

Radius is in an early phase of development right now. We welcome feedback in the form of issues that comes from usage and is aligned with the current scope and goals of the project.

Using an AI agent? Start with AGENTS.md, the single entry point that orients GitHub Copilot, Claude Code, and other agents working in this repository.

Ways to contribute

There are many ways to get involved and make a meaningful impact on the Radius project:

• Learn the codebase. Browse the contributor documentation for guides on prerequisites, building, testing, debugging, schema changes, design documents, and more.
• Tackle small tasks. Start with a "good first issue" to familiarize yourself with the project without a steep learning curve.
• Take on bigger projects. Issues that are groomed and ready to be picked up are labeled "triaged".
• Contribute to designs. Larger features need a design review before implementation; design proposals are created in the design-notes repository.
• Submit pull requests. Fork the repository, make your changes, and open a pull request with a clear description of the purpose and benefits of your changes.
• Help with code reviews. Give feedback and help with changes made by others.
• Engage with the community. Participate in discussions, forums, and chat channels related to Radius — seek guidance, offer help, and build connections.
• Test and report bugs. Detailed bug reports help us address issues promptly and improve quality.
• Improve documentation. Enhance the Radius documentation by updating content, adding guides, or adding examples.
• Spread the word. Share your experiences through blog posts, talks, or social media, and star the project on GitHub!

For all contributor guides and conventions, see the contributor documentation.

Current status

We welcome small pull request contributions from anyone (docs improvements, bug fixes, minor features.) as long as they follow a few guidelines:

• For very minor changes like correcting a typo feel free to send a pull request. Otherwise ...
• Please start by choosing an existing issue, or opening an issue to work on.
• The maintainers will respond to your issue, please work with the maintainers to ensure that what you're doing is in scope for the project before writing any code.
• If you have any doubt whether a contribution would be valuable, feel free to ask.

Developer Certificate of Origin

The Radius project follows the Developer Certificate of Origin. This is a lightweight way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project.

Contributors sign-off that they adhere to these requirements by adding a Signed-off-by line to commit messages.

This is my commit message

Signed-off-by: Random J Developer <random@developer.example.org>

Git even has a -s command line option to append this automatically to your commit message:

git commit -s -m 'This is my commit message'

Visual Studio Code has a setting, git.alwaysSignOff to automatically add a Signed-off-by line to commit messages. Search for "sign-off" in VS Code settings to find it and enable it.

Code of conduct

This project has adopted the Contributor Covenant. For more information see CODE_OF_CONDUCT.md