May 18, 2025 · May 17, 2025 · May 18, 2025 · May 18, 2025 · May 17, 2025 · May 18, 2025
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
 `JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_ object literal syntax
 (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):

   :param object_hook:
      If set, a function that is called with the result of
      any object literal decoded (a :class:`dict`).
      anyJSONobject literal decoded (a :class:`dict`).
      The return value of this function will be used
      instead of the :class:`dict`.
      This feature can be used to implement custom decoders,

   :param object_pairs_hook:
      If set, a function that is called with the result of
      any object literal decoded with an ordered list of pairs.
      anyJSONobject literal decoded with an ordered list of pairs.
      The return value of this function will be used
      instead of the :class:`dict`.
      This feature can be used to implement custom decoders.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -18,12 +18,17 @@ is a lightweight data interchange format inspired by
		`JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_ object literal syntax
		(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 DownExpand Up		@@ -279,7 +284,7 @@ Basic Usage

		:param object_hook:
		If set, a function that is called with the result of
		any object literal decoded (a :class:`dict`).
		anyJSONobject literal decoded (a :class:`dict`).
		The return value of this function will be used
		instead of the :class:`dict`.
		This feature can be used to implement custom decoders,
Expand All		@@ -289,7 +294,7 @@ Basic Usage

		:param object_pairs_hook:
		If set, a function that is called with the result of
		any object literal decoded with an ordered list of pairs.
		anyJSONobject literal decoded with an ordered list of pairs.
		The return value of this function will be used
		instead of the :class:`dict`.
		This feature can be used to implement custom decoders.
Expand Down