Skip to content

Commit eceb7b5

Browse files
committed
Restore Open Questions section with notes on deferred extensions
Add documentation about webhook notifications and capabilities extensions that were discussed but deferred to avoid complexity and ecosystem fragmentation during initial Upload 2.0 rollout.
1 parent 1811f7c commit eceb7b5

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

peps/pep-0694.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1030,6 +1030,26 @@ you can simply use the placeholder version number ``"0.0.0"``.
10301030
The user that created the session will become the owner of the new project.
10311031

10321032

1033+
Open Questions
1034+
==============
1035+
1036+
Extensions to the Upload 2.0 Protocol
1037+
-------------------------------------
1038+
1039+
Features such as asynchronous webhook notifications for completion of upload processing
1040+
were discussed during review of this PEP.
1041+
The concept of a capabilities extension for the upload protocol was discussed,
1042+
which would allow implementers to advertise support for optional features
1043+
such as asynchronous notifications or webhooks.
1044+
1045+
This idea was left open due to the complexity that would arise in designing
1046+
such an extension protocol and ensuring that it did not cause excessive
1047+
fracturing of the ecosystem as Upload 2.0 is rolled out.
1048+
1049+
Future revisions to the upload protocol should explore such extensions
1050+
as experience is gained operating Upload 2.0.
1051+
1052+
10331053
.. rubric:: Footnotes
10341054

10351055
.. [#fn-action] Obsolete ``:action`` values ``submit``, ``submit_pkg_info``, and ``doc_upload`` are

0 commit comments

Comments
 (0)