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