Skip to content

Commit 6fcd2c3

Browse files
committed
Deprecation -> freezing
Signed-off-by: William Woodruff <william@astral.sh>
1 parent 5448971 commit 6fcd2c3

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

peps/pep-9999.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
PEP: 9999
2-
Title: Deprecating the HTML simple repository API
2+
Title: Freezing the HTML simple repository API
33
Author: William Woodruff <william@yossarian.net>
44
Sponsor: TODO
55
PEP-Delegate: TODO
@@ -14,19 +14,19 @@ Post-History: `13-Apr-2026 <https://discuss.python.org/t/106959>`__
1414
Abstract
1515
========
1616

17-
This PEP proposes formally deprecating the
17+
This PEP proposes freezing the
1818
:ref:`standard HTML representation <packaging:simple-repository-html-serialization>`
1919
of the simple repository API, as originally specified in :pep:`503`
2020
and updated over subsequent PEPs.
2121

22-
In this context of this PEP, *deprecation* means that the HTML representation
23-
is considered *frozen* from the perspective of the standards process,
22+
In this context of this PEP, "freezing" means that the HTML representation
23+
is considered complete from the perspective of the standards process,
2424
and **SHOULD NOT** be updated by future PEPs. Future PEPs **SHOULD** instead
2525
target the
2626
:ref:`standard JSON representation <packaging:simple-repository-api-json>`,
2727
as originally specified in :pep:`691`.
2828

29-
Similarly, this PEP's deprecation of the HTML representation does **not** imply
29+
Similarly, this PEP's freezing of the HTML representation does **not** imply
3030
that installers should remove support for the HTML representation, or that
3131
indices (like PyPI) will or should stop providing an HTML representation.
3232

@@ -100,15 +100,15 @@ The purpose of this PEP is to formalize this status quo.
100100
Specification
101101
=============
102102

103-
The HTML representation of the simple repository API is deprecated
103+
The HTML representation of the simple repository API is frozen
104104
for the purposes of Python packaging standards processes. Future
105105
Python packaging PEPs **SHOULD NOT** modify the HTML representation of the
106106
simple repository API, and **MUST** instead modify the JSON representation.
107107

108108
This PEP does not alter the status of the HTML representation on PyPI
109109
and does not prescribe any behavioral changes for installers.
110110

111-
One functional consequence of this deprecation is that future changes
111+
One functional consequence of this freeze is that future changes
112112
to the simple repository API will be
113113
:ref:`versioned <packaging:simple-repository-api-versioning>` as they are
114114
currently, but that only the JSON representation will receive changes
@@ -166,13 +166,13 @@ Security Implications
166166
=====================
167167

168168
This PEP does not identify and positive or negative security implications
169-
associated with deprecating the HTML representation of the simple repository
169+
associated with freezing the HTML representation of the simple repository
170170
API.
171171

172172
How to Teach This
173173
=================
174174

175-
Because this PEP only deprecates the HTML representation of the simple repository
175+
Because this PEP only freezes the HTML representation of the simple repository
176176
API for the purposes of Python packaging standards processes, the end user
177177
implications of this PEP are limited.
178178

@@ -212,7 +212,7 @@ Encouraging indices and installers to aggressively remove support for the HTML
212212
representation is another option. However, as noted above, this is unrealistic
213213
in the near term, and would be disruptive to the ecosystem.
214214

215-
The authors of this PEP believe that deprecation is a more gradual and
215+
The authors of this PEP believe that freezing is a more gradual and
216216
pragmatic approach that better reflects the ecosystem's reality.
217217

218218
Copyright

0 commit comments

Comments
 (0)