diff --git a/peps/pep-0833.rst b/peps/pep-0833.rst index e5fd62bfabd..20b65c328c5 100644 --- a/peps/pep-0833.rst +++ b/peps/pep-0833.rst @@ -110,9 +110,10 @@ Specification ============= The HTML representation of the simple repository API is frozen -for the purposes of Python packaging standards processes. Future -Python packaging PEPs **SHOULD NOT** modify the HTML representation of the -simple repository API, and **MUST** instead modify the JSON representation. +for the purposes of Python packaging standards processes. +Future Python packaging PEPs **MUST** target the JSON representation as the +primary form of the simple repository API. They **SHOULD NOT** make changes to +the HTML representation. This PEP does not alter the status of the HTML representation on PyPI and does not prescribe any behavioral changes for installers. @@ -199,7 +200,9 @@ representations, this PEP proposes the following if accepted: - The authors of this PEP will make appropriate changes to the :ref:`living standard ` for the simple repository API, including admonitions and callouts where appropriate - to indicate that the HTML representation will not receive future updates. + to indicate that the HTML representation will not receive future updates + and that consumers who wish to benefit from future updates should + prefer the JSON representation instead. Rejected Ideas ==============