Skip to content

Latest commit

 

History

History
26 lines (20 loc) · 1.28 KB

CONTRIBUTING.md

File metadata and controls

26 lines (20 loc) · 1.28 KB
Raw

How to contribute

We are happy about contributions to AMICI in any form (new functionality, documentation, bug reports, ...).

Making code changes

When making code changes:

  • Check if you agree to release your contribution under the conditions provided in LICENSE
  • Start a new branch from master
  • Implement your changes
  • Submit a pull request
  • Make sure your code is documented appropriately
    • Run mtoc/makeDocumentation.m to check completeness of your documentation
  • Make sure your code is compatible with C++11, gcc and clang
  • when adding new functionality, please also provide test cases (see tests/cpputest/)
  • Write meaningful commit messages
  • Run all tests to ensure nothing got broken
    • Run tests/cpputest/wrapTestModels.m followed by CI tests scripts/buildAll.sh && scripts/run-cpputest.sh
    • Run tests/testModels.m
  • When all tests are passing and you think your code is ready to merge, request a code review

Adding/Updating tests

To add new tests add a new corresponding python script (see, e.g., tests/example_dirac.py) and add it to and run tests/generateTestConfigurationForExamples.sh To update test results replace tests/cpputest/expectedResults.h5 by tests/cpputest/writeResults.h5.bak [ONLY DO THIS AFTER TRIPLE CHECKING CORRECTNESS OF RESULTS]