From 15d725cbb146d376becb7c15d7cdeb92a0213299 Mon Sep 17 00:00:00 2001
From: Viicos <65306057+Viicos@users.noreply.github.com>
Date: Sun, 3 May 2026 18:02:20 +0200
Subject: [PATCH] gh-136216: Updated mentioned RFC in `json` module

---
 Doc/library/json.rst                                      | 8 ++++----
 .../2026-05-03-18-00-35.gh-issue-136216.89n3dv.rst        | 2 ++
 2 files changed, 6 insertions(+), 4 deletions(-)
 create mode 100644 Misc/NEWS.d/next/Documentation/2026-05-03-18-00-35.gh-issue-136216.89n3dv.rst

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index b354e7ba534835..89762b74a23583 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -9,7 +9,7 @@
 --------------
 
 `JSON (JavaScript Object Notation) <https://json.org>`_, specified by
-:rfc:`7159` (which obsoletes :rfc:`4627`) and by
+:rfc:`8259` (which obsoletes :rfc:`7159`) and by
 `ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_,
 is a lightweight data interchange format inspired by
 `JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_ object literal syntax
@@ -632,7 +632,7 @@ Exceptions
 Standard Compliance and Interoperability
 ----------------------------------------
 
-The JSON format is specified by :rfc:`7159` and by
+The JSON format is specified by :rfc:`8259` and by
 `ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_.
 This section details this module's level of compliance with the RFC.
 For simplicity, :class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and
@@ -850,8 +850,8 @@ Command-line options
 
 .. rubric:: Footnotes
 
-.. [#rfc-errata] As noted in `the errata for RFC 7159
-   <https://www.rfc-editor.org/errata_search.php?rfc=7159>`_,
+.. [#rfc-errata] As noted in `the errata for RFC 8259
+   <https://www.rfc-editor.org/errata_search.php?rfc=8259>`_,
    JSON permits literal U+2028 (LINE SEPARATOR) and
    U+2029 (PARAGRAPH SEPARATOR) characters in strings, whereas JavaScript
    (as of ECMAScript Edition 5.1) does not.
diff --git a/Misc/NEWS.d/next/Documentation/2026-05-03-18-00-35.gh-issue-136216.89n3dv.rst b/Misc/NEWS.d/next/Documentation/2026-05-03-18-00-35.gh-issue-136216.89n3dv.rst
new file mode 100644
index 00000000000000..8052100cec32d9
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2026-05-03-18-00-35.gh-issue-136216.89n3dv.rst
@@ -0,0 +1,2 @@
+Document support for :rfc:`8259` in :mod:`json` module, which obsoletes
+:rfc:`7159`.