Skip to content

Latest commit

 

History

History
41 lines (31 loc) · 1.44 KB

CONTRIBUTING.md

File metadata and controls

41 lines (31 loc) · 1.44 KB

Contributing to MindTheQApp

Contributions are highly welcome! :hugging_face:

Start of by..

  1. Creating an issue using one of the templates (Bug Report, Feature Request)
    • let's discuss what's going wrong or what should be added
    • can you contribute with code? Great! Go ahead! 🚀
  2. Forking the repository and working on your stuff. See the sections below for details on how to set things up.
  3. Creating a pull request to the main repository

Setup

Contributing to this project requires some more dependencies besides the "standard" packages. Those are specified in the groups dev and docs.

poetry install --with dev,docs

Additionally, we have pre-commit hooks in place, which can be installed as follows:

poetry run pre-commit autoupdate
poetry run pre-commit install

Currently the only purpose of the hook is to run Black on commit which will do some code formatting for you. However be aware, that this might reject your commit and you have to re-do the commit.

Testing

We do our testing with Pytest. Corresponding tests can be triggered as follows:

poetry run pytest

There are Github action pipelines in place, that will do linting and testing once you open a pull request. However, it's a good idea to run tests and linting (either Black or Flake8) locally before pushing.

Documentation

There is no official documentation page. You can find all the required information within the app or in the README.