Skip to content

Contribution guide

Maintaining a repository is a lot of work and it is only possible with the input for its users. That's why we love to get your feedback and continuously improve! We want to make contributing to this project as easy and transparent as possible. That's why we ask all contributions to go through a GitHub workflow.

Ask a question, report a bug, or suggest new features

Wether you wish to report a bug, discuss the current state of the code, how to use it, or propose new features, the GitHub repository is the place to start.

Go to 'Issues' in the repository's menu and use the search bar to look for your issue/question - maybe the discussion already exists! If you don't find what you are looking for, use the green button 'New Issue' and describe your problem/question with as many details as possible.

Bug reports

Solving Bugs is not always easy and usually requires to be able to precisely understand what happened. Try to include the following in your report, so we can solve the problems quickly:

  • A quick summary and/or background
  • The pipeline version
  • A precise description of the problem (what did you do? What happened?)
  • Join input data that can reproduce the problem, if possible
  • Attach relevant log files to the issue

Improving the documentation

Writting a documentation is a big task and we are gratefull for any help to expand and improve it.

If you find a specific section of the documentation unclear or incomplete, we would love to hear about it!

Submitting changes

All changes in the repository are made through pull requests.

Github worflow

To submitt a pull request:

  • Fork the repository and create your branch from main
  • Make your changes to the code base/documentation/tests
  • Test all your changes thoroughly
  • Update the documentation
  • Ensure that your code passes the tests and lints, this will be automatically tested when you submit your pull request
  • Issue your pull request with a detailled description of the changes and wait for a maintainer to review the changes

Please provide precise and sufficient information on the changes you performed when you submit your pull request.

License

By submitting changes to this repository, you agree that your contributions will be licensed under its GNU/GPL license.