We appreciate your interest in contributing to DeepOF! This guide details how to contribute to the DeepOF project in a way that is efficient for everyone.
All contributors are expected to adhere to the project's Code of Conduct. Please read the document before contributing.
-
Fork the project repository and clone your fork:
git clone git@github.com:mlfpm/deepof.git -
Create a new branch for your changes:
git checkout -b name-of-your-branch -
Make your changes and commit them:
git commit -m "Detailed commit message" -
Push your changes to your fork:
git push origin name-of-your-branch -
Create a pull request from your branch to the DeepOF main branch.
There are many ways you can contribute, beyond writing code. If you can write, draw, design, or organize, we would love your help. Here are some ways to contribute:
- Improve documentation
- Fix bugs or add new features
- Design UI or graphics
- Write tutorials or blog posts
- Review code submissions
- Test the application and report issues
We use the Black code formatter for this project. Please ensure your contributions adhere to this standard before submitting a pull request. You can check and format your code using Black:
black your_file.py
Black will automatically format your code to meet the style guide.
Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
- Fork the repo and create your branch from
main. - If you've added code that should be tested, add tests.
- If you've changed APIs, update the documentation.
- Ensure the test suite passes.
- Make sure your code lints and is formatted with Black.
- Issue that pull request!
We use GitHub issues to track public bugs and requests. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
Don't hesitate to contact us if you have any questions. Contact @lucasmiranda42 or ask your question on issues.
Thank you for your contributions!