| Contributing to Python |
| ====================== |
| |
| Build Status |
| ------------ |
| |
| - `Buildbot status overview <https://buildbot.python.org/#/release_status>`_ |
| |
| - `GitHub Actions status <https://github.com/python/cpython/actions/workflows/build.yml>`_ |
| |
| |
| Thank You |
| --------- |
| First off, thanks for contributing to the maintenance of the Python programming |
| language and the CPython interpreter! Even if your contribution is not |
| ultimately accepted, the fact you put time and effort into helping out is |
| greatly appreciated. |
| |
| |
| Contribution Guidelines |
| ----------------------- |
| Please read the `devguide <https://devguide.python.org/>`_ for |
| guidance on how to contribute to this project. The documentation covers |
| everything from how to build the code to submitting a pull request. There are |
| also suggestions on how you can most effectively help the project. |
| |
| Please be aware that our workflow does deviate slightly from the typical GitHub |
| project. Details on how to properly submit a pull request are covered in |
| `Lifecycle of a Pull Request <https://devguide.python.org/getting-started/pull-request-lifecycle.html>`_. |
| We utilize various bots and status checks to help with this, so do follow the |
| comments they leave and their "Details" links, respectively. |
| |
| The final key part of our workflow is that all discussions that are not |
| directly related to the code in the pull request should happen on |
| `GitHub Issues <https://github.com/python/cpython/issues>`__, generally in the |
| pull request's parent issue. |
| |
| |
| Setting Expectations |
| -------------------- |
| Due to the fact that this project is run by volunteers, |
| unfortunately we cannot make any guarantees as to if |
| or when a core developer will get around to reviewing your pull request. |
| If no core developer has done a review or responded to changes made because of a |
| "changes requested" review within a month, you can ask for someone to |
| review your pull request via a post in the `Core Development Discourse |
| category <https://discuss.python.org/c/core-dev/23>`__. |
| |
| |
| Code of Conduct |
| --------------- |
| All interactions for this project are covered by the |
| `PSF Code of Conduct <https://www.python.org/psf/codeofconduct/>`_. Everyone is |
| expected to be open, considerate, and respectful of others no matter their |
| position within the project. |
