.. include:: header.rst

==========================
<EP number> — <title>
==========================

:Author:  <name and optional e-mail; use ``:Authors:`` for a list>
:Discussions-To: <current discussion thread and/or enhancement ticket URL>
:Status:  <Draft | Active | Accepted | Provisional | Deferred |
          Rejected | Withdrawn | Final | Superseded>
:Created: <yyyy-mm-dd>

  .. optional
:Docutils-Version: <first release including the new feature>
:Post-History: <past discussion threads and/or issue tickets>
:Type:    <Standard (default) | Informational | Process>
:Topic:   <API | reStructuredText | DocTree | HTML output | ...>
:Requires: <EP number(s)>
:Replaces: <current EP, policy or API document>
:Superseded-By: <EP number>
:Resolution: <`yyyy-mm-dd <link to decision>`__>

:Abstract:
  .. A short (<~200 word) description of the technical issue being addressed.

.. contents::


Motivation
==========

.. Clearly explain why the existing specification is inadequate to
   address the problem that the proposal solves.


Rationale
=========

.. Describe why particular design decisions were made.


Specification
=============

.. Describe the syntax and semantics of any new 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 proposal 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 proposal
   were not ultimately pursued.


Open Issues
===========

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


References
==========

.. A collection of footnotes and references.


Copyright
=========

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