Merge pull request #11823 from rapidsai/branch-22.10

[gpuCI] Forward-merge branch-22.10 to branch-22.12 [skip gpuci]

python/cudf/cudf/utils/ioutils.py

@@ -596,7 +596,30 @@
           a         b
 0   "hello"   "hello"
 1  "rapids"  "worlds"
-"""
+
+Reading a JSON string containing ordered lists and name/value pairs:
+
+>>> json_str = '[{"list": [0,1,2], "struct": {"k":"v1"}}, {"list": [3,4,5], "struct": {"k":"v2"}}]'
+>>> cudf.read_json(json_str, engine='cudf_experimental')
+        list       struct
+0  [0, 1, 2]  {'k': 'v1'}
+1  [3, 4, 5]  {'k': 'v2'}
+
+Reading JSON Lines data containing ordered lists and name/value pairs:
+
+>>> json_str = '{"a": [{"k1": "v1"}]}\n{"a": [{"k1":"v2"}]}'
+>>> cudf.read_json(json_str, engine='cudf_experimental', lines=True)
+                a
+0  [{'k1': 'v1'}]
+1  [{'k1': 'v2'}]
+
+Using the `dtype` argument to specify type casting:
+
+>>> json_str = '{"k1": 1, "k2":[1.5]}'
+>>> cudf.read_json(json_str, engine='cudf_experimental', lines=True, dtype={'k1':float, 'k2':cudf.ListDtype(int)})
+    k1   k2
+0  1.0  [1]
+"""  # noqa: E501
 doc_read_json = docfmt_partial(docstring=_docstring_read_json)
 
 _docstring_to_json = """