From 8ae7ad5c10bac8291ad29f05997b026ac2d75ab6 Mon Sep 17 00:00:00 2001 From: Mike Farah Date: Fri, 1 Dec 2023 11:39:30 +1100 Subject: [PATCH] Updating JSON doc: NDJSON spec deprecated, prefer JSON Lines --- usage/convert.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/usage/convert.md b/usage/convert.md index 5060f8da..83357dba 100644 --- a/usage/convert.md +++ b/usage/convert.md @@ -125,9 +125,7 @@ will output {"whatever":"cat"} ``` -## Roundtrip NDJSON -Unfortunately the json encoder strips leading spaces of values. - +## Roundtrip JSON Lines / NDJSON Given a sample.json file of: ```json {"this": "is a multidoc json file"} @@ -147,7 +145,7 @@ will output ``` ## Roundtrip multi-document JSON -The NDJSON parser can also handle multiple multi-line json documents in a single file! +The parser can also handle multiple multi-line json documents in a single file (despite this not being in the JSON Lines / NDJSON spec). Typically you would have one entire JSON document per line, but the parser also supports multiple multi-line json documents Given a sample.json file of: ```json @@ -229,7 +227,7 @@ will output {"a number":4} ``` -## Decode NDJSON +## Decode JSON Lines / NDJSON Given a sample.json file of: ```json {"this": "is a multidoc json file"}