1 files changed, 35 insertions, 0 deletions
diff --git a/docs/library/json.rst b/docs/library/json.rst
new file mode 100644
index 000000000..21574e556
--- /dev/null
+++ b/docs/library/json.rst
@@ -0,0 +1,35 @@
+:mod:`json` -- JSON encoding and decoding
+==========================================
+
+.. module:: json
+   :synopsis: JSON encoding and decoding
+
+|see_cpython_module| :mod:`cpython:json`.
+
+This modules allows to convert between Python objects and the JSON
+data format.
+
+Functions
+---------
+
+.. function:: dump(obj, stream)
+
+   Serialise ``obj`` to a JSON string, writing it to the given *stream*.
+
+.. function:: dumps(obj)
+
+   Return ``obj`` represented as a JSON string.
+
+.. function:: load(stream)
+
+   Parse the given ``stream``, interpreting it as a JSON string and
+   deserialising the data to a Python object.  The resulting object is
+   returned.
+
+   Parsing continues until end-of-file is encountered.
+   A :exc:`ValueError` is raised if the data in ``stream`` is not correctly formed.
+
+.. function:: loads(str)
+
+   Parse the JSON *str* and return an object.  Raises :exc:`ValueError` if the
+   string is not correctly formed.