summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNguyễn Gia Phong <mcsinyx@disroot.org>2020-10-19 22:34:17 +0700
committerNguyễn Gia Phong <mcsinyx@disroot.org>2020-10-19 22:37:10 +0700
commit279e735969f609d927cce7e41576e46149c758c0 (patch)
tree905ce42a6f180b43ad1197560bb183e6111f3d59
parent08c99b6e00135ca8df2e98db58aa0b701b971c64 (diff)
downloadpip-279e735969f609d927cce7e41576e46149c758c0.tar.gz
Update docs for less common news extension
Namely trivial, vendor and process. These were missed during the trasition to *.rst news fragment.
-rw-r--r--docs/html/development/contributing.rst16
-rw-r--r--news/e1831861-84a4-4f9b-9987-762e127cb42b.trivial.rst0
2 files changed, 8 insertions, 8 deletions
diff --git a/docs/html/development/contributing.rst b/docs/html/development/contributing.rst
index 3d2d5ead0..3cdbb309d 100644
--- a/docs/html/development/contributing.rst
+++ b/docs/html/development/contributing.rst
@@ -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
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
-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
-``touch news/$(uuidgen).trivial``. On Windows, the same result can be achieved
-in Powershell using ``New-Item "news/$([guid]::NewGuid()).trivial"``. Core
-committers may also add a "trivial" label to the PR which will accomplish the
-same thing.
+``touch news/$(uuidgen).trivial.rst``. On Windows, the same result can be
+achieved in Powershell using ``New-Item "news/$([guid]::NewGuid()).trivial"``.
+Core committers may also add a "trivial" label to the PR which will accomplish
+the same thing.
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
uses the library name as the key so that updating the same library twice doesn't
produce two news file entries.
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
-typically used, but can be used for things like changing version schemes,
+otherwise notable can be done using a ``news/<name>.process.rst`` file. This is
+not typically used, but can be used for things like changing version schemes,
updating deprecation policy, etc.
diff --git a/news/e1831861-84a4-4f9b-9987-762e127cb42b.trivial.rst b/news/e1831861-84a4-4f9b-9987-762e127cb42b.trivial.rst
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/news/e1831861-84a4-4f9b-9987-762e127cb42b.trivial.rst