[Json] Re: Proposal for use of JSON Text vs JSON Document in JSON Schema

Rob Sayre <sayrer@gmail.com> Mon, 18 May 2026 23:53 UTC

Return-Path: <sayrer@gmail.com>
X-Original-To: json@mail2.ietf.org
Delivered-To: json@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id 9E96EF06A78E for <json@mail2.ietf.org>; Mon, 18 May 2026 16:53:15 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1779148395; bh=6kYBnF8VTRZZUoeyF/8ePmcACTq4D6MJQSbzEhvRPBU=; h=References:In-Reply-To:From:Date:Subject:To:Cc; b=ck9m+ljHTWFHe+SRETXw9uz7PLJPgQH3/YcnLFfa9jEXf0tRxNgHJlYdzoMK331Sq t+KzohQpxOlDXw+PUM9G39WKmVbmZShCKOGc+je6wG56ecnCr0xLXGxiKN62+Dgm8c 1/8rW/taO+SDx7Y4fZ6Iip15MlEytWb+PGmkPn+A=
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -1.098
X-Spam-Level:
X-Spam-Status: No, score=-1.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, FREEMAIL_REPLY=1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=no autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id hGXX_rNuVarO for <json@mail2.ietf.org>; Mon, 18 May 2026 16:53:15 -0700 (PDT)
Received: from mail-pg1-x529.google.com (mail-pg1-x529.google.com [IPv6:2607:f8b0:4864:20::529]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id 4A8C9F06A789 for <json@ietf.org>; Mon, 18 May 2026 16:53:15 -0700 (PDT)
Received: by mail-pg1-x529.google.com with SMTP id 41be03b00d2f7-c822652f82aso2466435a12.3 for <json@ietf.org>; Mon, 18 May 2026 16:53:15 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; t=1779148394; cv=none; d=google.com; s=arc-20240605; b=e+LJpl5WM5+neYtEIXxUlMoTl6Ad2oY7iIHRPdhJw4DYbMkm9zNK9NgN9y37iQ5oTa lOOCacU62N33/yWA0RGatm6ohpT2h17mwlwwMxjQrP7/y7YW5LQFNpkvhA6vS9pgaUu1 9jKJeiwuSjx/llpNfKD6jKm4mOP94gf7+nzS/hbYU4Zu2rXb+6OPSZtw5ijv3HDYbYyZ hobG9qGkpHNSmvVs+VjRN0EynqvboV+2hkRp5Yai9YI268MCvjWDnj2DYcv8E/EnPeDq RqxHUjzhAAi65i2ex/i98AynG3ufyey19WxXVm2/LI5auNGt6a9nITod+gL9P3+AuwJP coaQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:dkim-signature; bh=lZQwgStAxegHAvLBYLZF+SZb8giforSpi1pWhoZIRJc=; fh=wpZjGYN8qysZ44ANC0jS4EMPmft7TnnNeLR5ufIMb3Y=; b=dQKhzi9KfZSsdmGChBEvkdWGYKc9IoSci3IYeupUxy+tZQMoJ3B60aDyRAInoQQbdw VuHOrdadfI+YadvWDjd3orBH11/U8odD66lsm0S2LKkXjb3IsiUTa3rZa1mb84Ph6x26 rclcDG4F8nvhtho4UafIKLh52aqZKvw2q1FUitsl6UCF9mBC6UYbIRbYFNmDjv9Jm+Ay ovYg5WuOhfi8R8BdwZpKq3JkqK1fVVkZ5T18FKStSLq2HoiOh/0G9Tn2gO0HFWvoxQSS SUTEHb85J4TgWiEM1VeNTZoEj20mL6UeM3hZwk9nrbbEiDTVPXVGdoJCrn2dEhTYYJYx BHOQ==; darn=ietf.org
ARC-Authentication-Results: i=1; mx.google.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1779148394; x=1779753194; darn=ietf.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=lZQwgStAxegHAvLBYLZF+SZb8giforSpi1pWhoZIRJc=; b=rMzQAxaa1urN18etWP3GnWa2qsZYPctUZThsbZEz2ltrSYqTQJhPoTHQmE92wt6b+Q GtkeHQOKEME7uXrBKFcHn//AivksPfg9ylI7CqIGPSjJd/i4IVk23+1f4cffRdkNp1uV 6mqyDneUX89jQRrytTw/xLsbrJwJFYvzZ12pKv/iKqEAcY2kPYnuK6uTnbmFioJkFDNF PLrl5AwE+Pr7pqZGIdQXPImMT15VjxmBRcjU0TiI7U2nEouNKm8i8E14s38YVXEwSwh1 kROqC7V9QHL5JwsV8/Uwh6vkXG+MiM6JwgGDE0gQEOI70n6vC/YWVJDUTFU3zsDEgVpA YVDQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779148394; x=1779753194; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=lZQwgStAxegHAvLBYLZF+SZb8giforSpi1pWhoZIRJc=; b=dHfSKgZY8cAzwCjregPx3/VEq4Wmi70WXSXA41Qh1bw/au4p3c5mMG2WrI9UqfYf8V M4f3seNOp53x8trK0TxeygKKvWGSqsxTeJ2gpzkzzPyU4v2MSiqvOAFi/yxzMtRILKXL cVOZ8Sd4nkpPHfegweNU/ECc/+1nV9Mo1uT+nQeiBeJeU1phyKiOUzTPW2CoRFAP0mzy zCDpIGnXk59g7lUyl9Pqkn5SUqWm6LKlC08O8j7xfq3Ob4VSboHOlmefxNsAy5R8S+/E 3AZGlTi/yg91v9iPLrYymsivjvjfnKj2QBVa8VoMq9r5FeoW1I74IzkxW4cbxlEbIzFi 0BEw==
X-Forwarded-Encrypted: i=1; AFNElJ/RczaMlxPwbNbqiR7hl418l3LYIJ0QKN2Wwes/amNuGWXO87WIc4UQx3awsfUZaLo1JDqh@ietf.org
X-Gm-Message-State: AOJu0YyCJHsTVydjl4ya4pG4lIRbIJ6Z6EFYewsjUwtAGlWnaF9slG7l FHcee38DrG8Ysu+hf9jNYcSQpFH1V4SqzC6E563n3509+fGk1MY6NIXgmkYx0EdgAKdB7RN7rW9 2rev008qYHHscjewbg+AS1AwUF9jv6pk=
X-Gm-Gg: Acq92OGmYLFKtYDnBzdlzkuolOTHQIgs3d5bY3kcouWUfrhwDfozxqDXt73MbuSBXyM zGdnJMlrVCFHJopEh1/WGZJu8us7ToIxilFK3b1ejulwHBfm85JUpipTKSGX3CvsT3nNAnh7NMH 3l7G18i6TDhYX38Kjc5UxnKdg5b3FSVucK2jHgjvoFZ3BXjkMbZkjKlY59iwkBFojc2tazBUiKj gxkpHW15UUTqqOIfRQ/+X86kQWqt05xUV9/ozB3NN4IQnUaoeTwP5Q/fiOHa7VMwVZJXfKnC2SD w2k0MDg+AZJOxc5w6sqD02fTVKLMKJ6IwQZaPQ==
X-Received: by 2002:a05:6300:218a:b0:3a2:d838:bfc6 with SMTP id adf61e73a8af0-3b22ec97162mr20731765637.29.1779148394363; Mon, 18 May 2026 16:53:14 -0700 (PDT)
MIME-Version: 1.0
References: <CAEi+uC7geTKVn-NXkDsBaPo39dcKLMJ+G2ffFW4229mJd-O5_w@mail.gmail.com> <CAChr6SxM0+tEvGupGvukfBO7SkAf_dLyof91JwFfxzXR9wnupA@mail.gmail.com> <b3ada5ce-f72d-4730-bfaf-1e00b2af67a2@it.aoyama.ac.jp>
In-Reply-To: <b3ada5ce-f72d-4730-bfaf-1e00b2af67a2@it.aoyama.ac.jp>
From: Rob Sayre <sayrer@gmail.com>
Date: Mon, 18 May 2026 16:53:02 -0700
X-Gm-Features: AVHnY4LR7df1C5FydsdBsq4TRMuyBtkb73w7JyS-WfYaxuOzxsmTuO0680nTRjE
Message-ID: <CAChr6Sz+u=8tg3_VgahrCBMb4vhy_JbE0ed1N48dpR9CnhYXaw@mail.gmail.com>
To: "Martin J. Dürst" <duerst@it.aoyama.ac.jp>
Content-Type: multipart/alternative; boundary="0000000000000c7eb70652204498"
Message-ID-Hash: LD2GR75QPMKNTOC32UAXPRWLKLHBFLM7
X-Message-ID-Hash: LD2GR75QPMKNTOC32UAXPRWLKLHBFLM7
X-MailFrom: sayrer@gmail.com
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-json.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: Lisa Dusseault <lisa.dusseault@gmail.com>, JSON WG <json@ietf.org>
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [Json] Re: Proposal for use of JSON Text vs JSON Document in JSON Schema
List-Id: "JavaScript Object Notation (JSON) WG mailing list" <json.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/json/-ExcpmlGtmKbqys7f_vj0YSE6uI>
List-Archive: <https://mailarchive.ietf.org/arch/browse/json>
List-Help: <mailto:json-request@ietf.org?subject=help>
List-Owner: <mailto:json-owner@ietf.org>
List-Post: <mailto:json@ietf.org>
List-Subscribe: <mailto:json-join@ietf.org>
List-Unsubscribe: <mailto:json-leave@ietf.org>

Nope, they always want the source locations too. :)

So, I'll respectfully disagree.

thanks,
Rob


On Mon, May 18, 2026 at 4:46 PM Martin J. Dürst <duerst@it.aoyama.ac.jp>
wrote:

> Hello Rob, Lisa, others,
>
> On 2026-05-19 07:31, Rob Sayre wrote:
> > On Mon, May 18, 2026 at 3:21 PM Lisa Dusseault <lisa.dusseault@gmail.com
> >
> > wrote:
>
> > Also, whenever someone says "Abstract Syntax Tree", they almost always
> mean
> > "Concrete Syntax Tree" or just "parse tree".
>
> I think this depends on the values of 'someone/they' and the
> interpretation of 'almost always'.
>
> However, in our context (data models), it would be a mistake to use
> "Concrete Syntax Tree" or "parse tree". This would include syntax such
> as the square brackets used to delimit arrays in JSON text as leaves of
> the tree. An Abstract Syntax Tree just has the array elements as the
> children of an array node, and is the right thing to use here.
>
> Regards,   Martin.
>