Skip to content

Commit 050c203

Browse files
Converted contrubtions from rst to md
1 parent 3188357 commit 050c203

File tree

2 files changed

+139
-129
lines changed

2 files changed

+139
-129
lines changed

CONTRIBUTING.md

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
---
2+
title: Contributing
3+
---
4+
5+
Contributions are welcome, and they are greatly appreciated! Every
6+
little bit helps, and credit will always be given.
7+
8+
You can contribute in many ways:
9+
10+
# Types of Contributions
11+
12+
## Report Bugs
13+
14+
Report bugs at <https://github.com/shankarpandala/lazypredict/issues>.
15+
16+
If you are reporting a bug, please include:
17+
18+
- Your operating system name and version.
19+
- Any details about your local setup that might be helpful in
20+
troubleshooting.
21+
- Detailed steps to reproduce the bug.
22+
23+
## Fix Bugs
24+
25+
Look through the GitHub issues for bugs. Anything tagged with \"bug\"
26+
and \"help wanted\" is open to whoever wants to implement it.
27+
28+
## Implement Features
29+
30+
Look through the GitHub issues for features. Anything tagged with
31+
\"enhancement\" and \"help wanted\" is open to whoever wants to
32+
implement it.
33+
34+
## Write Documentation
35+
36+
Lazy Predict could always use more documentation, whether as part of the
37+
official Lazy Predict docs, in docstrings, or even on the web in blog
38+
posts, articles, and such.
39+
40+
## Submit Feedback
41+
42+
The best way to send feedback is to file an issue at
43+
<https://github.com/shankarpandala/lazypredict/issues>.
44+
45+
If you are proposing a feature:
46+
47+
- Explain in detail how it would work.
48+
- Keep the scope as narrow as possible, to make it easier to
49+
implement.
50+
- Remember that this is a volunteer-driven project, and that
51+
contributions are welcome :)
52+
53+
# Get Started!
54+
55+
Ready to contribute? Here\'s how to set up [lazypredict]{.title-ref} for
56+
local development.
57+
58+
1. Fork the [lazypredict]{.title-ref} repo on GitHub.
59+
60+
2. Clone your fork locally:
61+
62+
``` shell
63+
$ git clone [email protected]:your_name_here/lazypredict.git
64+
```
65+
66+
3. Install your local copy into a virtualenv. Assuming you have
67+
virtualenvwrapper installed, this is how you set up your fork for
68+
local development:
69+
70+
``` shell
71+
$ mkvirtualenv lazypredict
72+
$ cd lazypredict/
73+
$ python setup.py develop
74+
$ pip install -r requirements_dev.txt
75+
```
76+
77+
4. Create a branch for local development:
78+
79+
``` shell
80+
$ git checkout -b name-of-your-bugfix-or-feature
81+
```
82+
83+
Now you can make your changes locally.
84+
85+
5. When you\'re done making changes, check that your changes pass
86+
flake8 and the tests, including testing other Python versions with
87+
tox:
88+
89+
``` shell
90+
$ flake8 lazypredict tests
91+
$ python setup.py test or pytest
92+
$ tox
93+
```
94+
95+
To get flake8 and tox, just pip install them into your virtualenv.
96+
97+
6. Commit your changes and push your branch to GitHub:
98+
99+
``` shell
100+
$ git add .
101+
$ git commit -m "Your detailed description of your changes."
102+
$ git push origin name-of-your-bugfix-or-feature
103+
```
104+
105+
7. Submit a pull request through the GitHub website.
106+
107+
# Pull Request Guidelines
108+
109+
Before you submit a pull request, check that it meets these guidelines:
110+
111+
1. The pull request should include tests.
112+
2. If the pull request adds functionality, the docs should be updated.
113+
Put your new functionality into a function with a docstring, and add
114+
the feature to the list in README.rst.
115+
3. The pull request should work for Python 2.7, 3.5, 3.6, 3.7 and 3.8,
116+
and for PyPy. Check
117+
<https://travis-ci.org/shankarpandala/lazypredict/pull_requests> and
118+
make sure that the tests pass for all supported Python versions.
119+
120+
# Tips
121+
122+
To run a subset of tests:
123+
124+
``` shell
125+
$ pytest tests.test_lazypredict
126+
```
127+
128+
# Deploying
129+
130+
A reminder for the maintainers on how to deploy. Make sure all your
131+
changes are committed (including an entry in HISTORY.rst). Then run:
132+
133+
``` shell
134+
$ bump2version patch # possible: major / minor / patch
135+
$ git push
136+
$ git push --tags
137+
```
138+
139+
Travis will then deploy to PyPI if tests pass.

CONTRIBUTING.rst

Lines changed: 0 additions & 129 deletions
This file was deleted.

0 commit comments

Comments
 (0)