First of all, thank you for your interest in contributing! Any kind of contribution to traduora is more than welcome. Below you'll find some guidance on how to help with the project.
Running traduora locally with hot code reload
Assuming you have MySQL 5.7 running locally with a database called
root and empty password, from the project's root directory run the following:
Once ready, the API will be listening on
:8080 and the webapp on
Ways to help:
The starting point would be to get familiar with our product and the existing codebase, and know your way around. Read the docs, run it locally and generally get a feel for the product.
If you want to help out, there are lots of ways, for example:
- Working on new features
- Improving existing features
- Fixing bugs
- Helping with docs
- Telling your friends
Review Process for this Repo
When you submit a pull request, it goes through the review process outlined below. We aim to start reviewing pull requests in this repo the week they are submitted, but the length of time to complete the process will vary depending on the pull request.
Step 1: checking with the community
We recommend you to check the open issues and PRs on GitHub before working on your changes, there might already be some previous work on the same topic and you might want to be up to date.
Step 2: working on your changes
Simply follow the next steps:
- Fork the project.
- Create a new branch.
- Make your changes and write tests when practical.
- Commit your changes to the new branch.
- Send a pull request, it will be reviewed shortly.
Step 3: submit your PR
After a PR is submitted, a core committer will start reviewing your pull request and either give feedback or approve the PR. Any comments should be addressed before the pull request is merged.
Also please note that if the PR is a major change, the merge is likely to be postponed until the next release cycle.
Step 4: merging your PR
General requirements for merging:
- Run checks with
bin/check.sh(it will also auto format files).
- The PR must be approved by a core committer before merging.
- If there are any API changes, the documentation must be also updated.
- Anyone wishing to contribute to the github.com/traduora/traduora project must read & sign our Contributor License Agreement.
- Any relevant changes should have an entry in the changelog (you can add an entry under the
Once your PR is merged into
master, it will eventually land on the next release of traduora. Once again, thank you for contributing, we really appreciate it!