mirror of
https://github.com/twitter/the-algorithm-ml.git
synced 2024-12-23 06:41:49 +01:00
add contrib file
This commit is contained in:
parent
78c3235eee
commit
273e9877fc
65
CONTRIBUTING.md
Normal file
65
CONTRIBUTING.md
Normal file
@ -0,0 +1,65 @@
|
|||||||
|
# 🌍 Contributing.
|
||||||
|
|
||||||
|
Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
|
||||||
|
|
||||||
|
## 👶 Getting Started!
|
||||||
|
|
||||||
|
Ready to contribute? Here's how to set up `the-algorithm-ml` for local development.
|
||||||
|
|
||||||
|
1. Fork the `the-algorithm-ml` repo on GitHub.
|
||||||
|
2. Clone your fork locally:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone git@github.com:your_name_here/the-algorithm-ml.git
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Navigate to the recently created directory:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd the-algorithm-ml
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Install all required dependencies:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
pip install --no-deps -r images/requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Work on your local changes.
|
||||||
|
|
||||||
|
6. Test your local changes:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
pytest -vv
|
||||||
|
```
|
||||||
|
|
||||||
|
7. Install `pre-commit` as a git hook:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
pre-commit install
|
||||||
|
```
|
||||||
|
|
||||||
|
8. Create a branch for local development:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git checkout -b name-of-your-bugfix-or-feature
|
||||||
|
```
|
||||||
|
|
||||||
|
9. Commit your changes and push your branch to GitHub:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git add .
|
||||||
|
git commit -m "Your detailed description of your changes."
|
||||||
|
git push origin name-of-your-bugfix-or-feature
|
||||||
|
```
|
||||||
|
|
||||||
|
10. Submit a pull request through the GitHub website.
|
||||||
|
|
||||||
|
## 📙 Pull Request Guidelines.
|
||||||
|
|
||||||
|
Before you submit a pull request, check that it meets these guidelines:
|
||||||
|
|
||||||
|
1. You must sign our CLA (Contributor License Agreement) upon opening a PR.
|
||||||
|
2. The pull request should include tests, if applicable.
|
||||||
|
|
||||||
|
Thank you for helping us improve!
|
Loading…
Reference in New Issue
Block a user