Skip to content

Commit f5add10

Browse files
committed
Tweak conneg language
Signed-off-by: William Woodruff <william@astral.sh>
1 parent d82fc68 commit f5add10

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

peps/pep-9999.rst

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -152,9 +152,12 @@ difficult or infeasible, including:
152152
negotiation, and can often be served trivially by a CDN or a minimal
153153
HTTP server (like ``python -m http.server``).
154154

155-
By contrast, the JSON representation currently requires explicit content
156-
negotiation. Any future efforts to remove the HTML representation will likely
157-
require a simpler adoption story for the JSON representation.
155+
The JSON representation does not technically require content negotiation
156+
either, but in practice clients that consume it expect to perform
157+
explicit content negotiation due to the assumption that the same URL
158+
provides both representations. Consequently, any future efforts to remove the
159+
HTML representation will likely require a simpler adoption story for the JSON
160+
representation.
158161

159162
- The HTML representation is currently easier for installers like ``pip``
160163
to parse incrementally, as the Python standard library includes

0 commit comments

Comments
 (0)