Skip to content

PEP 9999: Freezing the HTML simple repository API#4930

Open
woodruffw wants to merge 3 commits intopython:mainfrom
woodruffw-forks:ww/deprecate-html-index
Open

PEP 9999: Freezing the HTML simple repository API#4930
woodruffw wants to merge 3 commits intopython:mainfrom
woodruffw-forks:ww/deprecate-html-index

Conversation

@woodruffw
Copy link
Copy Markdown
Contributor

@woodruffw woodruffw commented Apr 20, 2026

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
  • 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

📚 Documentation preview 📚: https://pep-previews--4930.org.readthedocs.build/

@woodruffw woodruffw force-pushed the ww/deprecate-html-index branch from cbc0191 to 0fd8fae Compare April 20, 2026 14:45
@woodruffw
Copy link
Copy Markdown
Contributor Author

NB: Waiting on a number assignment to open a DPO thread + update the CODEOWNERS 🙂

@woodruffw woodruffw marked this pull request as ready for review April 20, 2026 14:46
@woodruffw woodruffw requested a review from a team as a code owner April 20, 2026 14:46
@woodruffw
Copy link
Copy Markdown
Contributor Author

CC @dstufft to publicly confirm delegation/sponsorship as well!

Signed-off-by: William Woodruff <william@astral.sh>

Lint

Signed-off-by: William Woodruff <william@astral.sh>

More lint

Signed-off-by: William Woodruff <william@astral.sh>

Deprecation -> freezing

Signed-off-by: William Woodruff <william@astral.sh>

Mention optimization problems

Signed-off-by: William Woodruff <william@astral.sh>

Tweak conneg language

Signed-off-by: William Woodruff <william@astral.sh>

Update spon/delegate

Signed-off-by: William Woodruff <william@astral.sh>

Precision

Signed-off-by: William Woodruff <william@astral.sh>
@woodruffw woodruffw force-pushed the ww/deprecate-html-index branch from 0fd8fae to ad93554 Compare April 20, 2026 15:37
@encukou
Copy link
Copy Markdown
Member

encukou commented Apr 20, 2026

You can pick/reserve the next available number yourself -- though you'll need to change it if there's a conflict (or if PEP editors say so).

$ uvx pepotron next
Next available PEP: 833

Signed-off-by: William Woodruff <william@astral.sh>
@hugovk
Copy link
Copy Markdown
Member

hugovk commented Apr 20, 2026

I generally prefer to wait until the sponsor confirms, because if a PEP is abandoned (such as #4681) the PEP number also needs abandoning to avoid confusion that recycling could cause. And it'd be better to avoid gaps.

@woodruffw
Copy link
Copy Markdown
Contributor Author

Oops, OK. I'll revert 1ab5a02 for now.

This reverts commit 1ab5a02.
@dstufft
Copy link
Copy Markdown
Member

dstufft commented Apr 20, 2026

I'm fine on both accounts (Sponsor and Delegate)

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants