-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Description
We currently have https://peps.python.org/api/peps.json, an undocumented file.
It seems that people have usecases for the file, even without official support (see #2567, #2583). I suggest moving the file to the root1 for consistency with peps.rss and easier discoverability, and simultaneously documenting the file, and the minimum guarantees we provide about it.
In the issue that created it, Cam noted:
Maybe put this under an
/api/pepsendpoint (at least once we're ready to more publicly expose it)? Then if there was need/desire in the future, we could have anauthorsendpoint, sub-endpointsapi/peps/Nto get a single PEP's metadata, etc.
I think the api/ is uneeded here -- to those use cases, we could instead generate peps.python.org/pep-NNNN.json, and peps.python.org/authors.json.
I'd be interested in views.
A