Commit 81a2971d authored by Francesc Guasch's avatar Francesc Guasch
Browse files

Contributing guidelines

parent a1af184c
## Contributing
First off, thank you for considering contributing to Ravada. It's people
like you that make it such a great tool.
### 1. Where do I go from here?
If you've noticed a bug or have a question that doesn't belong on the
[mailing list](
[search the issue tracker](
to see if someone else in the community has already created a ticket.
If not, go ahead and [make one](!
### 2. Fork & create a branch
If this is something you think you can fix, then
[fork Active Admin](
and create a branch with a descriptive name.
A good branch name would be (where issue #325 is the ticket you're working on):
git checkout -b 325_boost_performance
If you contribute code, *thank you* ! Plase, follow this rules so our
code in sync:
- Use spaces, don't do tabs.
- Add the issue number at the very beggining of the commit message
``[#44] Fixed flux capacitor leak``
### 3. Get the tests running
See this documentation about [testing]( the project.
#### 4. Did you find a bug?
* **Ensure the bug was not already reported** by searching on GitHub under [Issues](
* If you're unable to find an open issue addressing the problem, [open a new one](
Be sure to include a **title and clear description**, as much relevant information as possible,
and a **code sample**, an **executable test case** or a step by step guide demonstrating the expected behavior that is not occurring.
### 5. Implement your fix or feature
At this point, you're ready to make your changes! Feel free to ask for help;
everyone is a beginner at first :smile_cat:
Follow this guide for running [](Ravada in development mode).
### 6. Make a Pull Request
At this point, you should switch back to your master branch and make sure it's
up to date with Ravada's master branch:
git remote add upstream
git checkout master
git pull upstream master
Then update your feature branch from your local copy of master, and push it!
git checkout 325_boost_performance
git rebase master
git push --set-upstream origin 325_boost_performance
Finally, go to GitHub and
[make a Pull Request](
### 7. Keeping your Pull Request updated
If a maintainer asks you to "rebase" your PR, they're saying that a lot of code
has changed, and that you need to update your branch so it's easier to merge.
To learn more about rebasing in Git, there are a lot of
but here's the suggested workflow:
git checkout 325_boost_performance
git pull --rebase upstream master
git push --force-with-lease 325_boost_performance
### 8. Merging a PR (maintainers only)
A PR can only be merged into master by a maintainer if:
* It is passing CI.
* It has been approved by at least one admin.
* It has no requested changes.
* It is up to date with current master.
Any maintainer is allowed to merge a PR if all of these conditions are
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment