How to contribute to Unlock
Thanks for your interest in contributing to Unlock! We're excited you're here. There are a variety of ways to contribute to the project.
We want Unlock to be a community where everyone can contribute. Please see the Code of Conduct for some rules that govern everyone's participation.
Issues and code
It's a good idea to start by familiarizing yourself with what's already being worked on. Take a look at the Unlock issue tracker to see:
- The complete list of open issues
- Requests for help wanted
- A list of good first issues for contributors looking for somewhere to get started
- Bugs that need to be fixed
Submitting a new issue
If you want to submit a new issue - whether it's a bug report or a request for a new feature - there are a few steps you should try first:
- Search the issue tracker to see if someone else has already submitted this issue (see the links above)
- Double-check to make sure it's a genuine issue: if it's a bug, can you reproduce it? If it's a feature request, does it make sense in the context of Unlock?
If you're sure you need to create a new issue, please make a best effort to follow the templates we've created. Be as specific as possible, including by using a clear, descriptive title for the issue. This allows contributors to address the issue you've uncovered with the most possible context.
Fixing an existing issue
When you're ready to contribute code, first check the following:
- Your code is well-documented
- Your classes, functions, interfaces, etc are all clearly-named
- Your style and naming conventions adhere to the style used in the rest of the codebase
smart-contracts/testfolders for the Unlock app and smart contracts respectively
Commit the code in a descriptive branch with a name that represents your contribution, in the form
Finally, submit a pull request, with the following rules:
- Don't include issue numbers in the title
- Do include relevant issue numbers in the description
- Include a concise, specific description of the complete pull request in the description
- Take care to exclude project workspace files and other collateral unnecessary to this project
You may be asked to revise your code or other aspects of your pull request. Please don't take this personally! We're delighted that you contributed, and we're grateful that you're a part of the community.
What if I'm not a coder?
We're excited for you to contribute. We're looking for copywriters, designers, testers - there are a lot of ways to contribute to the Unlock project without writing code. Keep an eye out for relevant issues in the issue tracker - and feel free to submit and contribute to issues using the above rules.
If you'd like to contribute but you're worried about where to start, you can always reach out to us at firstname.lastname@example.org. We'd love to help.