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

Rob Sayre <sayrer@gmail.com> Mon, 18 May 2026 22:31 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 8231BF06128E for <json@mail2.ietf.org>; Mon, 18 May 2026 15:31:25 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1779143485; bh=jZnJDi80rOdGySTBtNBRDaxnAM9ZjOCj8uchba/X5ds=; h=References:In-Reply-To:From:Date:Subject:To:Cc; b=fzgxqjnaJD3EDqbDpU6yfP+T3OCQ3xxBxDfbr3TOu4a9OGQWb6jLHKg5TtKwgkfsj b9vKcCMztp/TUMzegf1Q2Em3zebSjLGo6CUEI01CDSORJRmZthNdVWORqVEEI6Qcid QaxyPMx3H+WsZaKCcDa293S6UD+YjvFfmIbTNfmg=
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.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, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham 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 6HNYmVd1y9IP for <json@mail2.ietf.org>; Mon, 18 May 2026 15:31:25 -0700 (PDT)
Received: from mail-pj1-x102b.google.com (mail-pj1-x102b.google.com [IPv6:2607:f8b0:4864:20::102b]) (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 33852F061287 for <json@ietf.org>; Mon, 18 May 2026 15:31:25 -0700 (PDT)
Received: by mail-pj1-x102b.google.com with SMTP id 98e67ed59e1d1-369742178f8so1594605a91.0 for <json@ietf.org>; Mon, 18 May 2026 15:31:25 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; t=1779143484; cv=none; d=google.com; s=arc-20240605; b=i2TUYJB1mLEH3c3UxGVYsnxcx/kFJ56OuOB2cx0P4jYp519VkIPgogU0bmu7JkmSiD Kakv5XI9VHyhNu68mPA63g2qFCq7H5V4RwGdVW1/PAtBXmnKncDu7Kj9SRK0IZVqPE8i 2Ieym0A2rLh6fwLyuJx+xXo5T5b+Z6gFq7yMOo5OUwiXq1eJWcFCEk2v0wkNSdGdPwW7 jH8SpvZQPITQ1Xk2jXfve1ACDccYDmlIY66X2gsxkoIaYgpDGWVLERR5LtUqM9hVq4bZ NtqSrwc8sYiOKBIqe7QqxNUNVN1GExAG4xTFI+0oP8qfcqwTB7bhSqKCTzflzCDk8+LL G0pw==
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=jZnJDi80rOdGySTBtNBRDaxnAM9ZjOCj8uchba/X5ds=; fh=3iPEkAqDoBCRFOHRRYNqr7EmV3O2bTOhjO79Go6Cp+s=; b=Wleg0cV0573Hr/KUL9OXZRsyEgzsUQgfV50LwflnkVtc5OaT5HlRwKxDcZhZh6n5g4 dsTFgy5Say/DTFH2yZGwo05R8eHjrB2UC6VLJ6Typ4Bhvp+g0ll8dWfDtPubdcR7ec2h YmaaevPZTCs9q66p/oNqgoWrx3UFB9CRN2q5LkwazJRA1X7ItyB3WY7cRk5cJdk2X+Ai SNsgSiLnnFvDTHrtRs6wcp3dvNYdg8/uzZx1IKZzo7QT52ktbXfSbNHUC2SrqAmz+3YT aswsZxsHZbvEUqah7U4UuQ0QVkJzIxqIEB7eYH6/9gI5s4msTteK0IQM6F/IDY16sR1F ohGQ==; 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=1779143484; x=1779748284; 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=jZnJDi80rOdGySTBtNBRDaxnAM9ZjOCj8uchba/X5ds=; b=aGpnquH+2ktuI+f6lwG70GH5AqtNllMBoq/2rBrbkFfseQsXTzDVoRGsZUqOHZb+J3 xz1D7STX5T4618e48AohaZBDxwsIXtWKTDgMeZGfcVUg7DWjVCaphGUmCiQ2sNFPr0LL JnP0lL2YqmeuVFDErxuMjc8eji+iWWJ3BNWr1sj60jBIoFjrnYyREvNn6J+RCbhQX0ep 1dP44trSRv/Lsc3gqRkT2JGwhkWKCxXjTZw1WmZnEa/Y42je5VARnOSDrdlb0BLFXetg TFKJxC7Lk5J33yaouHHuWIN/agyVkJWuFqhKa5Wu4lMtjL5k12fUhiMpdIpZcbmcJiJB KQ8w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779143484; x=1779748284; 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=jZnJDi80rOdGySTBtNBRDaxnAM9ZjOCj8uchba/X5ds=; b=LpahH0Pq17bN9WDqoLU5HTGXUrhThXSATcve3zgurNcGZMPBH/7zL/56ks85X70Ilv HYgA2eL7kfjc/81/Iyh8uqzvTu2M8mIlcHv1s0A4j6us2rFxuKkcyH5X6X0A9VKJh/X0 UQBzaL2QzyB5bSjqUp9Y+y9/0MgamHkOn5A/A3dy09Fou33e+lvNTaabXkCG5axkHpy7 aLocSXSyZwahg5+Jvyc+ef6ZYvHbBcqRFeF2Qb+g16k3P2j0lhy05IHhHssgauM68jOy 6dle/0nYZBOO2enh7YcjwCHVzZ5LWnr0qW2+hZEimZp4CEVTLoVigo2bpkfkcbrbyEDD IEcg==
X-Gm-Message-State: AOJu0Yz5tyrN/AhQNbcKnQlqm/SaTH3bawOujH+A8IXvuff/rmbTAXTG XMAhdWWfDhpaV6kYKxi3EjDwsGWSRlxU4xpKksu91cujCm+Hwlqm72hEYCaWErP+2F3aV5UI3Hw AhSUla1g1UD7h7ZlazHeD59ar80xOS7w=
X-Gm-Gg: Acq92OE5QoGYGCT3uyY3w9+XC74gfjFUK1vjs59d2t3imbs+eBTsdClFDXVLO+ZYmnQ 5JPdTekav/xLGbXPkiiBf/gWqhWRy9SPfmqzPV5V+eddN9AyPfoJCgcCDCtkymcsqKoHaMczz85 8lW9xkyY7XukJQp6TV9qaHc8JwHIz4sDjar4ppwSaiGu1/vWSgbFgMXeIYpW1xembxprqMxQTu3 5w4Ar8uKSo8byGbhWEizzpE5Hj3jDZ6mSNagGy69qrD2ivTei3jvgcR2e79eNe9HHvlhsXnqr4o 7BafD7qko06eoKH+WJhNQ++1JRfv/EpX/AC8GboDT1LWbAlIP2ZlcLYZkpAALuki0LJ0
X-Received: by 2002:a17:90b:3c10:b0:369:a359:b189 with SMTP id 98e67ed59e1d1-369a35a15a7mr8268924a91.19.1779143484287; Mon, 18 May 2026 15:31:24 -0700 (PDT)
MIME-Version: 1.0
References: <CAEi+uC7geTKVn-NXkDsBaPo39dcKLMJ+G2ffFW4229mJd-O5_w@mail.gmail.com>
In-Reply-To: <CAEi+uC7geTKVn-NXkDsBaPo39dcKLMJ+G2ffFW4229mJd-O5_w@mail.gmail.com>
From: Rob Sayre <sayrer@gmail.com>
Date: Mon, 18 May 2026 15:31:11 -0700
X-Gm-Features: AVHnY4JzdNzRrc3abU3A0hPgozNmCQso1M4sNA10ChH9j8p6UA5SANIdsEScZ3w
Message-ID: <CAChr6SxM0+tEvGupGvukfBO7SkAf_dLyof91JwFfxzXR9wnupA@mail.gmail.com>
To: Lisa Dusseault <lisa.dusseault@gmail.com>
Content-Type: multipart/alternative; boundary="00000000000062acb906521f1fa4"
Message-ID-Hash: HYLSEAWR2KWNWOUWGEICJH3W5QELFRT2
X-Message-ID-Hash: HYLSEAWR2KWNWOUWGEICJH3W5QELFRT2
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: 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/N8b0oK69dftF8iaNmL2QvQrIAog>
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>

On Mon, May 18, 2026 at 3:21 PM Lisa Dusseault <lisa.dusseault@gmail.com>
wrote:

>
> Problem statement: "JSON Text" is defined in normative references
>

Hi,

No. It is "JSON text".

Sorry to be a giant pain, but we have to get the premise correct.

Also, whenever someone says "Abstract Syntax Tree", they almost always mean
"Concrete Syntax Tree" or just "parse tree".

I'm happy to go through and fix this stuff as a reviewer.

thanks,
Rob