diff options
| author | engn33r <engn33r@users.noreply.github.com> | 2021-02-24 23:18:10 -0500 |
|---|---|---|
| committer | engn33r <engn33r@users.noreply.github.com> | 2021-02-24 23:18:10 -0500 |
| commit | aa561086a4342c962fa5d4333f66b85c728c3624 (patch) | |
| tree | 04b826038aefe6454f94d263a890819db8896d33 /CONTRIBUTING.md | |
| parent | e39e64886d740eab92bfecb9351bb5d7e800a88b (diff) | |
| download | websocket-client-codecov-ci-dev.tar.gz | |
Update contribution guidelinescodecov-ci-dev
Diffstat (limited to 'CONTRIBUTING.md')
| -rw-r--r-- | CONTRIBUTING.md | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..9908aa1 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,57 @@ +# Contributing + +Hello :wave: and thank you for contributing! :tada: + +Before you contribute, please take a minute to review the contribution process +based on what you want to do. + +## I got an error or I have a question + +Great! We are happy to help. Before you ask your question, please check if your +question can be answered from the following 5 steps: +- [ ] The [project documentation examples](https://websocket-client.readthedocs.io/en/latest/examples.html) +- [ ] The [project documentation FAQ](https://websocket-client.readthedocs.io/en/latest/faq.html) +- [ ] Search for your question in [old existing issues](https://github.com/websocket-client/websocket-client/issues) +- [ ] If you encountered an error message, try googling the error message and see if you find an answer +- [ ] Check if the same issue exists if you uninstall the websocket-client +library on your system (using `pip uninstall websocket-client` or maybe +`pip3 uninstall websocket-client`) and install the +[latest master branch](https://github.com/websocket-client/websocket-client) +directly from GitHub by using `python setup.py install` +(see [installation info](https://github.com/websocket-client/websocket-client#installation)) + +If you did not get your question answered from these 5 steps, then please open a +new issue and ask your question! When you explain your problem, please: +- [ ] [Enable the tracing feature](https://websocket-client.readthedocs.io/en/latest/examples.html#debug-and-logging-options) +and include the entire debug trace of your connection process in the issue +- [ ] Add an explanation for what you are trying to accomplish. If you can +provide your code (or example code) in the issue, this helps a lot! + +## I have a suggestion or idea + +Great! Please make a new issue an explain your idea, but first do a quick search +in [old existing issues](https://github.com/websocket-client/websocket-client/issues) +to see if someone already proposed the same idea. + +## I want to contribute code + +Great! In your pull request (PR), please explain: +1. What is the problem with the current code +2. How your changes make it better +3. Provide some example code that can allow someone else to recreate the +problem with the current code and test your solution (if possible to recreate). + +## I want to contribute documentation + +Great! To edit the [project documentation](https://websocket-client.readthedocs.io), +it is recommended that you install Sphinx and build the updated documentation +locally before submitting your edits. The Sphinx dependencies can be +installed by navigating to the `docs/source` directory and running `pip install +-r requirements.txt`. To build a new version of the documentation, change +directories (or `cd`) to the `docs/` directory and run `make clean html`. +Any build warnings or errors will be displayed in your terminal, and the new +documentation will then be available in the `docs/build/html/` directory. +You may also find the +[Sphinx documentation style guide](https://documentation-style-guide-sphinx.readthedocs.io/en/latest/style-guide.html) +useful when editing reStructuredText (reST), which is quite +different from Markdown. |
