[discord]: https://discord.gg/jJxvuW97c4
[issues]: https://github.com/networked-aframe/networked-aframe/issues
[discussions]: https://github.com/networked-aframe/networked-aframe/discussions

Interested in contributing? As an open source project, we'd appreciate any help
and contributions! On top of the Networked-Aframe framework itself, you can also
contribute to this related component:

- [buffered-interpolation](https://github.com/InfiniteLee/buffered-interpolation)

# Join the Community on Discord

1. [Join the WebXR Discord][discord]
2. Select the #a-frame channel

# Get Help or Ask a Question

If you're not sure how to do something with Networked-Aframe, please post a message on Discord.

# File an Issue

1. Search the [issue tracker][issues] for similar issues.
2. Specify the version of Networked-Aframe in which the bug occurred.
3. Specify information about your browser and system (e.g., "Firefox Nightly on OS X")
4. Describe the problem in detail (i.e., what happened and what you expected would happen).
5. If possible, provide a small test case with StackBlitz, a link to your application, and/or a screenshot. You can fork the [naf-project](https://stackblitz.com/github/networked-aframe/naf-project) on StackBlitz.

# Contribute Code to Networked-Aframe

[README]: https://github.com/networked-aframe/networked-aframe/blob/master/README.md
[naf]: https://github.com/networked-aframe/networked-aframe
[aframe]: https://github.com/aframevr/aframe/
[pr]: https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github
[ssh]: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/
[tests]: https://github.com/aframevr/aframe/tree/master/tests#a-frame-unit-tests
[tutorial]: https://github.com/networked-aframe/networked-aframe/blob/master/docs/getting-started-local.md

Here's how to submit a pull request (PR):

1. Have a [GitHub account](https://github.com/join) with [SSH keys][ssh] set up.
2. [Fork](https://github.com/networked-aframe/networked-aframe/fork) the repository on GitHub.
3. Clone your fork of the repository locally (i.e., `git clone git@github.com:yourusername/networked-aframe`).
4. Run `npm install` to get dependencies and `npm run dev` to serve the test examples. [Follow this tutorial on how to get started][tutorial]
5. Create a branch to work in (i.e., `git checkout -b mybranch`).
6. Make changes to your fork of the repository, commit them, and push them (i.e., `git add -A . && git commit -m 'My Changes (fixes #1234)' && git push origin mybranch`).
7. If necessary, write [unit tests](tests/unit/) <!-- ([guide][tests]) --> and run with `npm run test`.
8. Make sure your code follows codestyle of the rest of the project.
9. If your commit changes the external API of Networked-Aframe update the [documentation][README]
9. [Submit a pull request][pr] to the master branch. If you head to the [Networked-Aframe repository][naf] after running `git push` from earlier, you should see a pop up to submit a pull request.
10. [Address review comments](http://stackoverflow.com/questions/9790448/how-to-update-a-pull-request) if any.

As per usual with open source, you would agree to license your contributions
under the [MIT License](LICENSE).

# Share your Work

1. Create something awesome with networked-aframe
2. Publish your work to Github (and GitHub pages) so everyone can learn from your work.
3. Share it on Discord on the #a-frame channel.
4. Let A-Frame know about it so they can retweet it. For this just tweet your project with a small video to @aframevr
4. For bonus points, write and publish a case study to explain how you built it.

# Help Your Fellow A-Framers

## On Discord

1. [Invite yourself][discord] to the WebXR Discord.
2. Select the #a-frame channel
3. Help answer questions that people might have and welcome new people.

## On GitHub

1. Help respond to [newly-filed GitHub discussions][discussions]

# Spread the Word

If you want to hold an event and talk about WebVR, A-Frame and/or Networked-Aframe, check out [the
presentation kit](https://github.com/aframevr/aframe-presentation-kit).

Thanks so much for contributing and helping grow WebXR!