PEP 387: Add a changelog and a missing Post-History entry (#3714)

Co-authored-by: Łukasz Langa <[email protected]>
Co-authored-by: Victor Stinner <[email protected]>

Author: 3 people

peps/pep-0387.rst

@@ -1,15 +1,13 @@
 PEP: 387
 Title: Backwards Compatibility Policy
-Version: $Revision$
-Last-Modified: $Date$
 Author: Benjamin Peterson <[email protected]>
 PEP-Delegate: Brett Cannon <[email protected]>
 Status: Active
 Type: Process
-Content-Type: text/x-rst
 Created: 18-Jun-2009
 Post-History: `19-Jun-2009 <https://mail.python.org/archives/list/[email protected]/thread/YAZQHFUCYEYIX5MIG6LFJLCVQ5ORVUM6/>`__,
               `12-Jun-2020 <https://discuss.python.org/t/pep-387-backwards-compatibilty-policy/4421>`__,
+              `19-Dec-2022 <https://discuss.python.org/t/22042>`__,
               `16-Jun-2023 <https://discuss.python.org/t/formalize-the-concept-of-soft-deprecation-dont-schedule-removal-in-pep-387-backwards-compatibility-policy/27957>`__
 
 
@@ -196,6 +194,21 @@ several releases:
    council.
 
 
+Changelog
+=========
+
+* 2023-Nov-14: Added ``@deprecated`` decorator per :pep:`702`.
+* 2023-Jul-03: Added the Soft Deprecation section, as discussed in
+  `<https://discuss.python.org/t/27957>`__.
+* 2023-Jun-26: Multiple smaller updates and clarifications, discussed in
+  `<https://discuss.python.org/t/22042>`__.
+* 2022-Apr-04: Added explicit notes to ask the Steering Council
+  in several exceptional cases.
+* 2021-Apr-16: Clarified how long a warning must be emitted before
+  a change can be made.
+* 2020-Jul-20: Initial accepted version.
+
+
 References
 ==========
 
@@ -212,14 +225,3 @@ Copyright
 =========
 
 This document has been placed in the public domain.
-
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   coding: utf-8
-   End: