May 18, 2025 · May 17, 2025 · May 18, 2025 · May 18, 2025 · May 17, 2025 · May 17, 2025
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
 `JSON (JavaScript Object Notation) <https://json.org>`_, specified by
 :rfc:`7159` (which obsoletes :rfc:`4627`) 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
 is a lightweight data interchange format inspired by the object literal syntax
 of`JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_
 (although it is not a strict subset of JavaScript [#rfc-errata]_ ).

 .. note::
   The term "object" in the context of JSON processing in Python can be
   ambiguous. All values in Python are objects. In JSON, an object refers to
   any data wrapped in curly braces, similar to a Python dictionary.

 .. warning::
   Be cautious when parsing JSON data from untrusted sources. A malicious
   JSON string may cause the decoder to consume considerable CPU and memory
   resources. Limiting the size of data to be parsed is recommended.

 :mod:`json` exposes an API familiar to users of the standard library
 This module exposes an API familiar to users of the standard library
 :mod:`marshal` and :mod:`pickle` modules.

 Encoding basic Python object hierarchies::
        "6": 7
    }

 Specializing JSON object encoding::
 Customizing JSON object encoding::

   >>> import json
   >>> def custom_json(obj):
    >>> json.load(io)
    ['streaming API']

 Specializing JSON object decoding::
 Customizing JSON object decoding::

    >>> import json
    >>> def as_complex(dct):
Original file line number	Diff line number	Diff line change
Expand Up		@@ -14,16 +14,21 @@
		`JSON (JavaScript Object Notation) <https://json.org>`_, specified by
		:rfc:`7159` (which obsoletes :rfc:`4627`) 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
		is a lightweight data interchange format inspired by the object literal syntax
		of`JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_
ZeroIntensity marked this conversation as resolved. Show resolvedHide resolved
		(although it is not a strict subset of JavaScript [#rfc-errata]_ ).

		.. note::
		The term "object" in the context of JSON processing in Python can be
		ambiguous. All values in Python are objects. In JSON, an object refers to
Copy link Contributor StanFromIrelandMay 17, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Glossary link to Python object? Copy link Member nedbatMay 18, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. In this case, I don't think a glossary link will help here. The reader in this case will know what a Python object is.
		any data wrapped in curly braces, similar to a Python dictionary.

		.. warning::
		Be cautious when parsing JSON data from untrusted sources. A malicious
		JSON string may cause the decoder to consume considerable CPU and memory
		resources. Limiting the size of data to be parsed is recommended.

		:mod:`json` exposes an API familiar to users of the standard library
		This module exposes an API familiar to users of the standard library
Copy link Contributor StanFromIrelandMay 17, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Again unrelated, please revert and do not make a mess of this pr. though it should be changed to :mod:`!json` Copy link Member ZeroIntensityMay 17, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. do not make a mess of this pr. @StanFromIreland Please be aware that this is a first-time contributor. Let's try to be more constructive by pointing to thedevguide. StanFromIreland reacted with thumbs up emoji Copy link Member nedbatMay 18, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. I think "This module" make a better sentence anyway.
		:mod:`marshal` and :mod:`pickle` modules.

		Encoding basic Python object hierarchies::
Expand DownExpand Up		@@ -60,7 +65,7 @@ Pretty printing::
		"6": 7
		}

		Specializing JSON object encoding::
		Customizing JSON object encoding::
Copy link Contributor StanFromIrelandMay 17, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Ditto Copy link Member nedbatMay 18, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Again, I think this is a better word, and we don't want to make a separate PR for it, it would be too much churn.

		>>> import json
		>>> def custom_json(obj):
Expand All		@@ -83,7 +88,7 @@ Decoding JSON::
		>>> json.load(io)
		['streaming API']

		Specializing JSON object decoding::
		Customizing JSON object decoding::
Copy link Contributor StanFromIrelandMay 17, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Ditto

		>>> import json
		>>> def as_complex(dct):
Expand Down