Skip to content

Latest commit

 

History

History
116 lines (79 loc) · 6.77 KB

CONTRIBUTING.md

File metadata and controls

116 lines (79 loc) · 6.77 KB

Contributing to this repository

Getting started

Before you begin:

Before you make your changes, check to see if an issue exists already for the change you want to make.

Don't see your issue? Open one

If you spot something new, open an issue using a template. I'll use the issue to have a conversation about the problem you want to fix.

Ready to make a change? Fork the repo

Fork using GitHub Desktop:

Fork using the command line:

  • Fork the repo so that you can make your changes without affecting the original project until you're ready to merge them.

Make your update:

Make your changes to the file(s) you'd like to update.

Open a pull request

When you're done making changes and you'd like to propose them for review, and open your PR (pull request).

Submit your PR & get it reviewed

  • Once you submit your PR, I will review it with you. The first thing you're going to want to do is a self review.
  • After that, I may have questions, check back on your PR to keep up with the conversation.
  • Did you have an issue, like a merge conflict? Check out the git tutorial on how to resolve merge conflicts and other issues.

Your PR is merged!

Congratulations! And thank you for contributing to an open-source VR application. You are a hero! ✨

Once your PR is merged, you will be proudly listed as a contributor in the contributor chart.

Plus, you will get to enjoy watching your contributions become live as they are pushed to Steam!

Keep contributing as you use LuxVR

Now that you're a part of the LuxVR community, you can keep participating in many ways.

Learn more about contributing:

Types of contributions 📝

You can contribute to LuxVR content in several ways. This repository is the place to discuss and collaborate!

🪲 Issues

Issues are used to track tasks that contributors can help with.

If you've found something in the content or the application that should be updated, search open issues to see if someone else has reported the same thing. If it's something new, open an issue using a template. I'll use the issue to have a conversation about the problem you want to fix.

If you'd like to

  • help others,
  • port to different operating systems,
  • share HMD test results,
  • troubleshoot,
  • share a great idea,

this is where you can do it!

Check out the issue labels and templates.


Github Discussions is currently in beta. I plan on transferring non-code related 'issues' to discussions.


🛠️ Pull requests

A pull request is a way to suggest changes in our repository.

When I merge those changes, they should be deployed to Steam. To learn more about opening a pull request in this repo, see Opening a pull request below.

❓ Support

As an indie VR/AR developer, I'll be doing my best to answer your questions and solve your problems regarding LuxVR. But I prefer to provide this support through the available channels of this repository, not via private messaging or e-mails.

Starting with an issue

You can browse existing issues to find something that needs help!

Labels

Labels can help you find an issue you'd like to help with.

Opening a pull request

You can use the GitHub user interface ✏️ for some small changes, like fixing a typo or updating a readme. You can also fork the repo and then clone it locally, to view changes and run your tests on your machine.

Reviewing

I will personally review every single PR. Yes.

Self-review

You should always review your own PR first before submitting.

Suggested changes

I may ask for changes to be made before a PR can be merged, either using suggested changes or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.

As you update your PR and apply changes, mark each conversation as resolved.