McSinyx
/
pip
mirror of https://github.com/pypa/pip
1
1
Fork 0
Code Issues Releases Activity

Merge pull request #9014 from McSinyx/docs-news-rst 

Update docs for less common news extension
This commit is contained in:
Pradyun Gedam 2020-10-26 18:09:26 +05:30 committed by GitHub
parent cffc3a618e 279e735969
commit ea74bd3d90
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/html/development/contributing.rst
View File

@ -109,22 +109,22 @@ A trivial change is anything that does not warrant an entry in the news file.
Some examples are: Code refactors that don't change anything as far as the Some examples are: Code refactors that don't change anything as far as the
public is concerned, typo fixes, white space modification, etc. To mark a PR public is concerned, typo fixes, white space modification, etc. To mark a PR
as trivial a contributor simply needs to add a randomly named, empty file to as trivial a contributor simply needs to add a randomly named, empty file to
the ``news/`` directory with the extension of ``.trivial``. If you are on a the ``news/`` directory with the extension of ``.trivial.rst``. If you are on a
POSIX like operating system, one can be added by running POSIX like operating system, one can be added by running
``touch news/$(uuidgen).trivial``. On Windows, the same result can be achieved ``touch news/$(uuidgen).trivial.rst``. On Windows, the same result can be
in Powershell using ``New-Item "news/$([guid]::NewGuid()).trivial"``. Core achieved in Powershell using ``New-Item "news/$([guid]::NewGuid()).trivial"``.
committers may also add a "trivial" label to the PR which will accomplish the Core committers may also add a "trivial" label to the PR which will accomplish
same thing. the same thing.
Upgrading, removing, or adding a new vendored library gets a special mention Upgrading, removing, or adding a new vendored library gets a special mention
using a ``news/<library>.vendor`` file. This is in addition to any features, using a ``news/<library>.vendor.rst`` file. This is in addition to any features,
bugfixes, or other kinds of news that pulling in this library may have. This bugfixes, or other kinds of news that pulling in this library may have. This
uses the library name as the key so that updating the same library twice doesn't uses the library name as the key so that updating the same library twice doesn't
produce two news file entries. produce two news file entries.
Changes to the processes, policies, or other non code related changed that are Changes to the processes, policies, or other non code related changed that are
otherwise notable can be done using a ``news/<name>.process`` file. This is not otherwise notable can be done using a ``news/<name>.process.rst`` file. This is
typically used, but can be used for things like changing version schemes, not typically used, but can be used for things like changing version schemes,
updating deprecation policy, etc. updating deprecation policy, etc.

0
news/e1831861-84a4-4f9b-9987-762e127cb42b.trivial.rst Normal file
View File