2.8 KiB
Contributing to webxr-polyfill
This is an open source project and we love to receive contributions from the community. There are many ways to contribute, from writing documentation, submitting bug reports and feature requests or writing code. We would also love to hear how you are using this code and to receive contributions that make it easier to deploy and integrate.
Bug reports
If you think you have found a bug, first make sure that you are testing against the master branch - your issue may already have been fixed. If not, search our issues list on GitHub in the event a similar issue has already been opened.
It is very helpful if you can provide enough information to replicate the bug. In other words, provide a small test case which we can run to confirm your bug. It makes it easier to find the problem and resolve it.
Provide as much information as you can. The easier it is for us to recreate your problem, the faster we can fix it.
Feature requests
If you are looking for a feature that doesn't exist currently, you are probably not alone. Open an issue on our issues list on GitHub which describes the feature you would like to see, the value it provides, and how it should work. If you attach diagrams or mockups, it would be super nice ;-).
Contributing code and documentation changes
If you have a bugfix or new feature that you would like to contribute, please search through our issues and see if one exists, or open an issue about it first. Explain what you would like to do. It is possible someone has already begun to work on it, or that there are existing issues that you should know about before implementing the change.
We enjoy working with contributors to get their code accepted. There are many approaches to fixing a problem and it is important to find the best approach before writing too much code.
The process is described below.
Fork and clone the repository
You will need to fork the main repository and clone it to your local machine. See github help page for help.
Push your local changes to your forked copy of the repository and submit a pull request. In the pull request, describe what your changes do and mention the number of the issue where discussion has taken place, eg "Closes #123".
Then sit back and wait. There will probably be discussion about the pull request, and if any changes are needed, we would love to work with you to get your pull request merged.