1
1
Fork 0
mirror of https://github.com/pypa/pip synced 2023-12-13 21:30:23 +01:00

Improve "Submitting Pull Requests" section

- Link to compatibility requirements and require compliance
- Move licensing details to come earlier
- Reword text on cosmetic changes
This commit is contained in:
Pradyun Gedam 2018-07-02 19:58:13 +05:30
parent 60ef05b013
commit 98ddd2dddc
No known key found for this signature in database
GPG key ID: DA17C4B29CB32E4B
2 changed files with 16 additions and 12 deletions

View file

@ -11,8 +11,14 @@ Submitting Pull Requests
========================
Submit pull requests against the ``master`` branch, providing a good
description of what you're doing and why. Provide tests that cover your changes
and run the tests locally first.
description of what you're doing and why. You must have legal permission to
distribute any code you contribute to pip and it must be available under the
MIT License.
Provide tests that cover your changes and run the tests locally first. pip
:ref:`supports <compatibility-requirements>` multiple Python versions and
operating systems. Any pull request must consider and work on all these
platforms.
Pull Requests should be small to facilitate easier review. Keep them
self-contained, and limited in scope. `Studies have shown`_ that review quality
@ -22,16 +28,12 @@ as "feature branches", with ongoing development work happening within the PR.
Instead, the feature should be broken up into smaller, independent parts which
can be reviewed and merged individually.
When creating a pull request, avoid including "cosmetic" changes to code that
Additionally, avoid including "cosmetic" changes to code that
is unrelated to your change, as these make reviewing the PR more difficult.
Examples include re-flowing text in comments or documentation, or addition or
removal of blank lines or whitespace within lines. Such changes can be made
separately, as a "formatting cleanup" PR, if needed.
You must have legal permission to distribute any code you contribute to
pip and it must be available under the MIT License.
Automated Testing
=================

View file

@ -104,6 +104,8 @@ On Windows [4]_::
python -m pip install -U pip
.. _compatibility-requirements:
Python and OS Compatibility
---------------------------