From 6bc3430fa6c48683e49e0481acacb6d0477587de Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Tue, 2 Jun 2026 16:06:01 -0400 Subject: [PATCH 1/2] Add a PEP 833 callout to the simple API spec Signed-off-by: William Woodruff --- source/specifications/simple-repository-api.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/specifications/simple-repository-api.rst b/source/specifications/simple-repository-api.rst index d317db6f7..f07cc8e5b 100644 --- a/source/specifications/simple-repository-api.rst +++ b/source/specifications/simple-repository-api.rst @@ -122,6 +122,15 @@ HTML Serialization .. _simple-repository-html-project-list: +.. important:: + + The HTML representation is considered "frozen" and is not expected + to be updated. Producers and consumers of the simple API + should prefer the :ref:`JSON representation `. + + See :pep:`833` for additional information about the HTML representation's + status. + The following constraints apply to all HTML serialized responses described in this spec: @@ -989,3 +998,4 @@ History * November 2024: provenance metadata in the HTML and JSON formats, in :pep:`740` * July 2025: project status markers in the HTML and JSON formats, in :pep:`792` * July 2025: layout changes (dedicated page for file yanking, introduce concepts before API details) +* June 2026: :pep:`833` formally "freezes" the HTML representation of the simple API \ No newline at end of file From 9a9aca9dc04ce7ecb782b7c07722598e03d979dd Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Tue, 2 Jun 2026 16:11:16 -0400 Subject: [PATCH 2/2] Fix EOF Signed-off-by: William Woodruff --- source/specifications/simple-repository-api.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/specifications/simple-repository-api.rst b/source/specifications/simple-repository-api.rst index f07cc8e5b..d7e14a4d3 100644 --- a/source/specifications/simple-repository-api.rst +++ b/source/specifications/simple-repository-api.rst @@ -998,4 +998,4 @@ History * November 2024: provenance metadata in the HTML and JSON formats, in :pep:`740` * July 2025: project status markers in the HTML and JSON formats, in :pep:`792` * July 2025: layout changes (dedicated page for file yanking, introduce concepts before API details) -* June 2026: :pep:`833` formally "freezes" the HTML representation of the simple API \ No newline at end of file +* June 2026: :pep:`833` formally "freezes" the HTML representation of the simple API