Skip to content

Latest commit

 

History

History
102 lines (72 loc) · 3.79 KB

CONTRIBUTING.md

File metadata and controls

102 lines (72 loc) · 3.79 KB

Contributing

🎉🥂 First off, thanks for taking the time to contribute! 🎉🥂

Contributions are always welcome, no matter how small!

If you think you can help in any of the areas of MOABB (and we bet you can) or in any of the many areas that we haven't yet thought of (and here we're sure you can) then please check out our roadmap.

Please note that it's very important to us that we maintain a positive and supportive environment for everyone who wants to participate. When you join us we ask that you follow our code of conduct in all interactions both on and offline.

The following is a small set of guidelines for how to contribute to the project

Where to start

Code of Conduct

This project adheres to the Contributor Covenant Code of Conduct. By participating you are expected to adhere to these expectations. Please report unacceptable behavior.

Contributing on Github

If you're new to Git and want to learn how to fork this repo, make your own additions, and include those additions in the master version of this project, check out this great tutorial.

Community

This project is maintained by the NeuroTechX community.

How can I contribute?

If there's a feature you'd be interested in building or you find a bug or have a suggestion on how to improve the project, go ahead! Let us know on the open an issue so others can follow along and we'll support you as much as we can. When you're finished submit a pull request to the master branch referencing the specific issue you addressed.

Steps to Contribute

  1. Look for open issues or open one
  2. Discuss the problem and or propose a solution
  3. Fork it! (and clone fork locally)
  4. Branch from develop: git checkout --track develop
  5. Setup development environment
  6. Create your feature branch: git checkout -b my-new-feature
  7. Make changes
  8. Commit your changes: git commit -m 'Add some feature'
  9. Don't forget to fix issues from pre-commit pipeline (either add changes made by hooks or fix them manually in case of flake8)
  10. Push to the branch: git push origin my-new-feature
  11. Submit a pull request. Make sure it is based on the develop branch when submitting! :D
  12. Don't forget to update the what's new and documentation pages if needed

Setup development environment

  1. Install pre-commit to start to code:
    pip install pre-commit
  2. Install the pre-commit hooks:
    pre-commit install
  3. you are ready to code!

Note 1:
Your first commit will trigger pre-commit to download Code Quality tools. That's OK and it is intended behavior. This will be done once per machine automatically.

Note 2 (deep learning):
In case you want to install the optional deep learning dependencies (i.e. pip install .[deeplearning]),

Tools used

MOABB uses pre-commit. It automatically runs variety of Code Quality instruments against the code you produced.

For Code Quality verification, we use:

  • black - Python code formatting
  • isort - imports sorting and grouping
  • flake8 - code style checking
  • prettier - .yml and .md files formatting
  • and more checkers.

Generate the documentation

To generate a local version of the documentation:

cd docs
make html