Skip to content

Latest commit

 

History

History
90 lines (54 loc) · 2.12 KB

pep-NNNN.rst

File metadata and controls

90 lines (54 loc) · 2.12 KB

PEP: <REQUIRED: pep number> Title: <REQUIRED: pep title> Author: <REQUIRED: list of authors' real names and optionally, email addrs> Sponsor: <real name of sponsor> PEP-Delegate: <PEP delegate's real name> Discussions-To: <REQUIRED: URL of current canonical discussion thread> Status: <REQUIRED: Draft | Active | Accepted | Provisional | Deferred | Rejected | Withdrawn | Final | Superseded> Type: <REQUIRED: Standards Track | Informational | Process> Topic: <Governance | Packaging | Release | Typing> Content-Type: text/x-rst Requires: <pep numbers> Created: <date created on, in dd-mmm-yyyy format> Python-Version: <version number> Post-History: <REQUIRED: dates, in dd-mmm-yyyy format, and corresponding links to PEP discussion threads> Replaces: <pep number> Superseded-By: <pep number> Resolution: <url>

Abstract

[A short (~200 word) description of the technical issue being addressed.]

Motivation

[Clearly explain why the existing language specification is inadequate to address the problem that the PEP solves.]

Rationale

[Describe why particular design decisions were made.]

Specification

[Describe the syntax and semantics of any new language feature.]

Backwards Compatibility

[Describe potential impact and severity on pre-existing code.]

Security Implications

[How could a malicious user take advantage of this new feature?]

How to Teach This

[How to teach users, new and experienced, how to apply the PEP to their work.]

Reference Implementation

[Link to any existing implementation and details about its state, e.g. proof-of-concept.]

Rejected Ideas

[Why certain ideas that were brought while discussing this PEP were not ultimately pursued.]

Open Issues

[Any points that are still being decided/discussed.]

Footnotes

[A collection of footnotes cited in the PEP, and a place to list non-inline hyperlink targets.]

Copyright

This document is placed in the public domain or under the CC0-1.0-Universal license, whichever is more permissive.