Contributing
April 1, 2026 ยท View on GitHub
We love pull requests from everyone. By participating in this project, you agree to abide by the code of conduct.
Fork, then clone the repo:
git clone git@github.com:your-username/doorkeeper.git
Docker Setup
Build the container image with: docker build --pull -t doorkeeper:test .
Run the tests with: docker run -it --rm doorkeeper:test
Local Setup
-
Set up Ruby dependencies via Bundler
bundle install -
Make sure the tests pass:
rake spec -
Make your changes.
-
Write tests.
-
Follow our style guides.
-
Make the tests pass:
rake spec -
Add notes about your changes to the
CHANGELOG.mdfile. -
Write a good commit message.
-
Push to your fork.
-
If [Rubocop] catches style violations, fix them. If our bot suggested changes โ please add them.
-
Wait for us. We try to at least comment on pull requests within one business day.
-
We may suggest changes.
-
Please, squash your commits to a single one if you introduced a new changes or pushed more than one commit. Let's keep the history clean.
Thank you for your contribution! :handshake: