Skip to content

Commit e4afcd2

Browse files
committed
Adding a CONTRIBUTING Guideline
1 parent b6d8c5b commit e4afcd2

File tree

2 files changed

+79
-0
lines changed

2 files changed

+79
-0
lines changed

CONTRIBUTING.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
## Contributing to HpBandSter
2+
3+
You are interested in developing a new feature or have found a bug?
4+
Awesome, feel welcome and read this guideline in order to find out how to best report your ideas so that we can include
5+
them as quickly as possible.
6+
7+
### Report security issues
8+
9+
You must never report security related issues, vulnerabilities or bugs including sensitive information to the bug tracker,
10+
or elsewhere in public. Instead sensitive bugs must be sent by email to one of the maintainers.
11+
12+
### New Features
13+
14+
We are always happy to read about your ideas on how to improve HpBandSter.
15+
If you find yourself wishing for a feature that doesn't exist in HpBandster,
16+
you are probably not alone. There are bound to be others out there with similar needs.
17+
Open an issue on our [issues list on GitHub](https://github.com/automl/HpBandSter/issues),
18+
and describe
19+
- the feature you would like to see
20+
- why you need it and
21+
- how it should work.
22+
23+
If you already know how to implement, we love pull requests.
24+
Please see the [Pull request](#pull-requests) section, to read further details on pull requests.
25+
26+
27+
### <a name="report-bugs"></a> Report Bugs
28+
29+
Report issues at <https://github.com/automl/HpBandSter/issues>
30+
31+
Before you report a bug, please make sure that:
32+
33+
1. Your bug hasn't already been reported in our [issue tracker](https://github.com/automl/HpBandSter/issues).
34+
2. You are using the latest HpBandSter version.
35+
36+
If you found a bug, please provide us the following information:
37+
38+
- Your operating system name and version
39+
- Any information about your setup that could be helpful to resolve the bug
40+
- A simple example that reproduces that issue would be amazing. But if you can't provide an example,
41+
just note your observations as much detail as you can.
42+
- Feel free, to add a screenshot showing the issue, if it helps.
43+
44+
If the issue needs an urgent fix, please mark it with the label "urgent".
45+
Then either fix it or mark as "help wanted".
46+
47+
### Work on own features
48+
49+
To work on own features, first you need to create a fork of the original repository.
50+
A good tutorial on how to do this is in the Github Guide: [Fork a repo](https://help.github.com/articles/fork-a-repo/).
51+
52+
You could install the forked repository via:
53+
54+
<pre>
55+
<code>git clone [email protected]:automl/HpBandSter.git
56+
cd HpBandSter
57+
python3 setup.py develop --user
58+
</code></pre>
59+
60+
### <a name="pull-requests"></a> Pull requests
61+
62+
If you have not worked with pull requests, you can learn how from this *free* series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
63+
Or read more in the official github documentation <https://help.github.com/articles/about-pull-requests/>
64+
65+
You know how to fix a bug or implement your own feature, follow this small guide:
66+
67+
- Check the issue tracker if someone has already reported the same idea or found the same bug.
68+
(Note: If you only want to make some smaller changes, opening a new issue is less important, as the changes can be
69+
discussed in the pull request.)
70+
- Create a pull request, after you have implemented your changes in your fork and make a pull request.
71+
Using a separate branch for the fix is recommend.
72+
- Pull request should include tests.
73+
- We are using the Google Style Python Docstrings. Take a look at this [example](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html).
74+
- The code should follow the PEP8 coding convention.
75+
- We try to react as fast as possible to your pull request, but if you haven't received a feedback from us after some days
76+
feel free to leave a comment on the pull request.
77+

codecov.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,5 @@ comment:
2828
ignore:
2929
- "hpbandster/examples/.*"
3030
- "hpbandster/workers/hpolibbenchmark.py"
31+
- "hpbandster/visualization.py"
32+
- "hpbandster/optimizers/lerning_curve_models/base.py

0 commit comments

Comments
 (0)