Contributing.md

Contributing

By participating in this project, you agree to abide our code of conduct.

Set up your machine

threshr is written in Java using Oracle's GraalVM and uses Maven to handle dependencies.

Prerequisites:

• Java 17.0.8 in graal's flavor Graal (community edition)
• Maven 3.8.6

Other things you might need to run the tests:

• Docker

Create your own fork of threshr, then clone your fork anywhere:

git clone git@github.com:Graqr/Threshr.git

cd into the directory and install the dependencies:

mvn clean compile

Branch off of main

It's a good practice not to put your changes in the main branch. Branch naming conventions aren't enforced, but I personally like naming my branches with a tag/task convention. See Create a commit.

See our style guide for supported coding practices.

Test your change

Adequate acceptance testing is to be included with pull requests for new code. See our style guide for our testing standards.

mvn clean test

Validate threshr builds

mvn clean install

Create a commit

Commit messages should be well formatted and conform to Conventional Commits.

Submit a pull request

Push your branch to your threshr fork and open a pull request against the original threshr main branch.