Thanks to visit codestin.com
Credit goes to github.com

Skip to content

PEP 1 & 12: Have Post-History link posts to preserve Discussions-To history #2358

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AA-Turner merged 4 commits into from
Mar 9, 2022
Merged

PEP 1 & 12: Have Post-History link posts to preserve Discussions-To history #2358

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4742dac
PEP 1 & 12: Have Post-History actually link posts, not just list dates
CAM-Gerlach Feb 23, 2022
1e49847
PEP 12: Eliminate unnecessary/redundant detail in Post-History instru…
CAM-Gerlach Feb 25, 2022
e4c39c3
PEP 1/12: Clarify language around Post-History links & make anonymous
CAM-Gerlach Mar 2, 2022
ceec060
PEP 1 & 12: More explictly describe Post-History link format
CAM-Gerlach Mar 8, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
PEP 1/12: Clarify language around Post-History links & make anonymous
  • Loading branch information
@CAM-Gerlach
CAM-Gerlach committed Mar 8, 2022
commit e4c39c35fdb72579b73599f37b5381b9b0016e0c
7 changes: 4 additions & 3 deletions pep-0001.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -600,8 +600,8 @@ optional and are described below. All other headers are required.
* Requires: <pep numbers>
Created: <date created on, in dd-mmm-yyyy format>
* Python-Version: <version number>
Post-History: <dates, in dd-mmm-yyyy format, and corresponding links to
PEP discussion threads>
Post-History: <dates, in dd-mmm-yyyy format,
inline-linked to PEP discussion threads>
* Replaces: <pep number>
* Superseded-By: <pep number>
* Resolution: <url>
Expand Down Expand Up @@ -658,7 +658,8 @@ Content-Type header is present.

The Created header records the date that the PEP was assigned a
number, while Post-History is used to record the dates of and corresponding
inline links to the Discussions-To threads for the PEP.
URLs to the Discussions-To threads for the PEP, with the former as the
linked text, and the latter as the link target.
Both headers should be in dd-mmm-yyyy format, e.g. 14-Aug-2001.

Standards Track PEPs will typically have a Python-Version header which
Expand Down
12 changes: 6 additions & 6 deletions pep-0012.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Status: Active
Type: Process
Content-Type: text/x-rst
Created: 05-Aug-2002
Post-History: `30-Aug-2002 <https://mail.python.org/archives/list/[email protected]/thread/KX3AS7QAY26QH3WIUAEOCCNXQ4V2TGGV/>`_
Post-History: `30-Aug-2002 <https://mail.python.org/archives/list/[email protected]/thread/KX3AS7QAY26QH3WIUAEOCCNXQ4V2TGGV/>`__


.. note::
Expand Down Expand Up @@ -123,14 +123,14 @@ directions below.
to this header each time you post your PEP to the designated discussion forum
(and update the ``Discussions-To`` header with said link, as above).
If you posted threads for your PEP on August 14, 2001 and September 3, 2001,
the Post-History header would look something like:
the Post-History header would look like, e.g.:

.. code-block:: email

Post-History: `14-Aug-2001 <https://www.example.com/thread_1>`_,
`03-Sept-2001 <https://www.example.com/thread_2>`_
Post-History: `14-Aug-2001 <https://www.example.com/thread_1>`__,
`03-Sept-2001 <https://www.example.com/thread_2>`__

You must manually add new dates/links as soon as you post a
You should add the new dates/links here as soon as you post a
new discussion thread.

- Add a Replaces header if your PEP obsoletes an earlier PEP. The
Expand Down Expand Up @@ -173,7 +173,7 @@ your PEP):
Requires: *[NNN]
Created: [DD-MMM-YYYY]
Python-Version: *[M.N]
Post-History: [`DD-MMM-YYYY <URL>`_]
Post-History: [`DD-MMM-YYYY <URL>`__]
Replaces: *[NNN]
Superseded-By: *[NNN]
Resolution:
Expand Down