Skip to content

PEP 847: "Problem Details for the Simple Repository API" - #5119

Open
woodruffw wants to merge 15 commits into
python:mainfrom
astral-sh:ww/rfc9457
Open

PEP 847: "Problem Details for the Simple Repository API"#5119
woodruffw wants to merge 15 commits into
python:mainfrom
astral-sh:ww/rfc9457

Conversation

@woodruffw

@woodruffw woodruffw commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Basic requirements (all PEP Types)

  • Read and followed PEP 1 & PEP 12
  • File created from the latest PEP template
  • PEP has next available number, & set in filename (pep-NNNN.rst), PR title (PEP 123: <Title of PEP>) and PEP header
    • Tip: find the next available number with pepotron — run uvx pepotron next (or pipx install pepotron then pep next)
  • Title clearly, accurately and concisely describes the content in 79 characters or less
  • Core dev/PEP editor listed as Author or Sponsor, and formally confirmed their approval
  • Author, Status (Draft), Type and Created headers filled out correctly
  • PEP-Delegate, Topic, Requires and Replaces headers completed if appropriate
  • Required sections included
    • Abstract (first section)
    • Copyright (last section; exact wording from template required)
  • Code is well-formatted (PEP 7/PEP 8) and is in code blocks, with the right lexer names if non-Python
  • PEP builds with no warnings, pre-commit checks pass and content displays as intended in the rendered HTML
  • Authors/sponsor added to .github/CODEOWNERS for the PEP

Standards Track requirements

  • PEP topic discussed in a suitable venue with general agreement that a PEP is appropriate
  • Suggested sections included (unless not applicable)
    • Motivation
    • Specification
    • Rationale
    • Backwards Compatibility
    • Security Implications
    • How to Teach This
    • Reference Implementation
    • Rejected Ideas
    • Open Issues
    • Acknowledgements
    • Footnotes
    • Change History
  • Python-Version set to valid (pre-beta) future Python version, if relevant
  • Any project stated in the PEP as supporting/endorsing/benefiting from the PEP formally confirmed such
  • Right before or after initial merging, PEP discussion thread created and linked to in Discussions-To and Post-History

@woodruffw
woodruffw requested a review from a team as a code owner September 8, 2026 16:54
@woodruffw

Copy link
Copy Markdown
Contributor Author

CCing @dstufft to confirm his sponsor/delegate roles 🙂

@woodruffw

Copy link
Copy Markdown
Contributor Author

(NB: per #4930 I'm not self-assigning a PEP number until Donald publicly acknowledges.)

Comment thread peps/pep-0847.rst
Zsolt Dollenstein <zsol.zsol@gmail.com>
Sponsor: Donald Stufft <donald@stufft.io>
PEP-Delegate: Donald Stufft <donald@stufft.io>
Discussions-To: https://discuss.python.org/t/pre-pep-discussion-rfc-9457-error-responses-for-package-registries/105453

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NB: I will do a follow-up PR for the new PEP thread shortly after this merges.

@read-the-docs-community

read-the-docs-community Bot commented Sep 8, 2026

Copy link
Copy Markdown

Documentation build overview

📚 pep-previews | 🛠️ Build #34473796 | 📁 Comparing 628f84d against latest (24419b9)

  🔍 Preview build  

6 files changed · + 1 added · ± 5 modified

+ Added

± Modified

Comment thread peps/pep-9999.rst Outdated
@hugovk hugovk changed the title PEP XXXX: "Problem Details for the Simple Repository API" PEP 847: "Problem Details for the Simple Repository API" Sep 9, 2026
woodruffw and others added 15 commits September 9, 2026 11:03
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Co-authored-by: Jelle Zijlstra <jelle@openai.com>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
Signed-off-by: William Woodruff <william@yossarian.net>
@dstufft

dstufft commented Sep 9, 2026

Copy link
Copy Markdown
Member

Yes I'm fine with both roles.

@brianschubert brianschubert added the new-pep A new draft PEP submitted for initial review label Sep 9, 2026
@woodruffw

Copy link
Copy Markdown
Contributor Author

Should be good to go now!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-pep A new draft PEP submitted for initial review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants