|
| 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 | + |
0 commit comments