summaryrefslogtreecommitdiff
path: root/.github/CONTRIBUTING.rst
blob: b61da1f7469deae5707eff4cc0ddd9341c611b16 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Read and contribute to CherryPy
-------------------------------

Make sure you read the `README
<https://github.com/cherrypy/cherrypy/blob/master/README.rst>`_. Also ensure
you set up `pre-commit utility <https://pre-commit.com/#install>`_
**correctly** and **TravisCI tests pass**::

  pre-commit run --all-files  # runs the same checks as in CI locally
  pre-commit install  # sets up itself as a pre-commit hook of your local repo

Submitting Pull Requests
------------------------
If you're changing the structure of the repository please create an issue
first. Don't forget to write appropriate test cases, add them into CI process
if applicable and make the TravisCI build pass.

Sync (preferably rebase) your feature branch with upstream regularly to make
us able to merge your PR seamlessly.

Submitting bug reports
----------------------

Make sure you are on latest changes and that you re-ran this command `tox`
after updating your local repository. If you can, please provide more
information about your environment such as browser, operating system,
python version, and any other related software versions.

Also
----
See `Contributing <http://docs.cherrypy.org/en/latest/contribute.html>`_ in
the docs.