Contributing to MRTK2

Mixed Reality Toolkit (MRTK) welcomes contributions from the community. All changes, large or small, need to adhere to the MRTK coding standards. Please ensure you are familiar with these while developing to avoid delays when the change is being reviewed.

If you have any questions, please reach out on the mixed-reality-toolkit channel on Slack. You can join the Slack community via the automatic invitation sender.

Submission processes

We provide several paths to enable developers to contribute to Mixed Reality Toolkit, all starting with creating a new Issue.

From here you file:

• Bug report - Functionality issue with one of Mixed Reality Toolkit components
• Documentation issue - Issue with Mixed Reality Toolkit documentation
• Feature request - Proposal for a new Mixed Reality Toolkit feature

Proposing feature requests

When requesting a new Mixed Reality Toolkit feature, it's important to document the customer benefit / problem to be solved. Once submitted, a feature request will be reviewed and discussed on GitHub. We encourage open and constructive discussion of each feature proposal to ensure that the work is beneficial to a large segment of customers.

To avoid needing to rework the feature, it's recommended that development of the feature doesn't begin during the review phase. Many times, the community review process uncovers one or more issues that may require significant changes in the proposed implementation.

Märkus

If you wish to work on something that already exists on our backlog, you can use that work item as your proposal. Be sure to also comment on the task notifying maintainers that you're working towards completing it.

Contribution process

To get started, follow these steps:

1. Fork the repository. Click on the "Fork" button on the top right of the page and follow the flow.
2. Create a branch in your fork (off of the main branch) to make it easier to isolate any changes until ready for submission. For bug fixes during a release stabilization period, look for the latest prerelease/* branch. New features should always go into main.

If you are new to the Git workflow, check out this introduction from GitHub.

When adding a bug fix or feature, follow these steps:

1. Implement the bug fix or feature. Instructions for building and deploying MRTK are at Deploying to HoloLens and WMR devices. Remember to follow the Coding Guidelines.
2. If adding a feature, also add an example scene that demonstrates the feature.
3. If adding an experimental feature, then writing tests and documentation isn't necessary. Instead, follow experimental feature guidelines.
4. Add tests to verify the bug fix / feature. Instructions for writing and running tests are at UnitTests.
5. Ensure the code and feature(s) are documented as described in the Documentation Guidelines.
6. Ensure the code works as intended on all platforms. See the Release notes for the list of supported platforms. For Windows UWP projects, code must be WACK compliant. To do this, generate a Visual Studio solution, right click on project; Store > Create App Packages. Follow the prompts and run WACK tests. Make sure they all succeed.
7. Follow the instructions at Pull Requests when making a pull request.