Visitar URL original
networked-aframe/CONTRIBUTING.md at master · networked-aframe/networked-aframe · GitHub
Skip to content

Latest commit

 

History

History
80 lines (57 loc) · 4.09 KB

CONTRIBUTING.md

File metadata and controls

80 lines (57 loc) · 4.09 KB

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:

Join the Community on Discord

  1. Join the WebXR 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 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 on StackBlitz.

Contribute Code to Networked-Aframe

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

  1. Have a GitHub account with SSH keys set up.
  2. 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
  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 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
  10. Submit a pull request to the master branch. If you head to the Networked-Aframe repository after running git push from earlier, you should see a pop up to submit a pull request.
  11. Address review comments if any.

As per usual with open source, you would agree to license your contributions under the MIT 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
  5. 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 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

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.

Thanks so much for contributing and helping grow WebXR!