Re: [Gen-art] Genart last call review of draft-ietf-jsonpath-base-17

Tim Bray <tbray@textuality.com> Thu, 10 August 2023 21:28 UTC

Return-Path: <tbray@textuality.com>
X-Original-To: gen-art@ietfa.amsl.com
Delivered-To: gen-art@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 73B14C193325 for <gen-art@ietfa.amsl.com>; Thu, 10 Aug 2023 14:28:49 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.105
X-Spam-Level:
X-Spam-Status: No, score=-2.105 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, HTML_MESSAGE=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=textuality.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id weRVs2CZoKwt for <gen-art@ietfa.amsl.com>; Thu, 10 Aug 2023 14:28:44 -0700 (PDT)
Received: from mail-lf1-x12a.google.com (mail-lf1-x12a.google.com [IPv6:2a00:1450:4864:20::12a]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6F58BC193326 for <gen-art@ietf.org>; Thu, 10 Aug 2023 14:28:44 -0700 (PDT)
Received: by mail-lf1-x12a.google.com with SMTP id 2adb3069b0e04-4fe21e7f3d1so2140963e87.3 for <gen-art@ietf.org>; Thu, 10 Aug 2023 14:28:44 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=textuality.com; s=google; t=1691702922; x=1692307722; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=LpdvfGQhyr4Bu8MiCaS97rKOAQ2a59044boVYSAg6lg=; b=VIaPh7+pgrayOWgaW4DpZiesbtt4YAJ0p3WJcw01p/jG6AS5Rfzaf5JZ7msnhTYddA kmeBebXtSvT8L10nHWpgGV9VA2HBVbR7/XlYVs99VaOg+vS/3kOJuPFoj1/tXqilRwGv QTpx5dPX4Fcd1oTK+4jccW4s5B+HToQA1eZZY=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691702922; x=1692307722; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=LpdvfGQhyr4Bu8MiCaS97rKOAQ2a59044boVYSAg6lg=; b=B3Y//OB6RooLk2IaFpMqstKg3C6dLC8Ejd+rrJYqRSGGSFkJYD9WGZJiG3VoMiGWUN k8ft/MVfE9X8sndE+gdp1vwH6TerWwbJb+UXD+AYYALVvt/I5zxCxdsJY1tfFUXZAiix yQX9QZ5fjftwzO77uDwauL19oG9S7o+xlK4PLgKBC+WlzX0u7zdtVVGK5scTzfvSiuhN LVp6UvHmL2MD4YaZq/C2YZ5ReDBuu31t0f1b4EdIPhMn/7bCdI2tLXOxdMobSxeOeV1w hEUae3L91cYF/sfomTeTyKCgoO9wT88Iaf2zcEkd8/KrOuxBDK/4u+nZY9F9Ssc99TdT mZiA==
X-Gm-Message-State: AOJu0Yw49X6i8HOcooicfAEW3wAAb2do634O6mWtQpDb9Rz2W/5xXaRM MbDbZm1t3SPNxVg778+ojWhNXsUjV4/uVT+RbZZSaA==
X-Google-Smtp-Source: AGHT+IHJs64AcG8urRnJcng7vr896NskHWeRMu4mV6GLjWCisQTVAsSecTTUgzfBjOP1PhSfongUD2Tg7mZ3qfiviWM=
X-Received: by 2002:a05:6512:3e1f:b0:4fe:5795:35ed with SMTP id i31-20020a0565123e1f00b004fe579535edmr3336883lfv.6.1691702922141; Thu, 10 Aug 2023 14:28:42 -0700 (PDT)
Received: from 1064022179695 named unknown by gmailapi.google.com with HTTPREST; Thu, 10 Aug 2023 14:28:41 -0700
Received: from 1064022179695 named unknown by gmailapi.google.com with HTTPREST; Thu, 10 Aug 2023 14:28:38 -0700
Mime-Version: 1.0 (Mimestream 1.0.5)
References: <169169150183.43222.18081751127010886819@ietfa.amsl.com>
In-Reply-To: <169169150183.43222.18081751127010886819@ietfa.amsl.com>
From: Tim Bray <tbray@textuality.com>
Date: Thu, 10 Aug 2023 14:28:41 -0700
Message-ID: <CAHBU6itQ7aHgZA8m0J+9ktdnCwWdkcCSgTU13gk1qoZyx1C-Fw@mail.gmail.com>
To: Linda Dunbar <linda.dunbar@futurewei.com>
Cc: draft-ietf-jsonpath-base.all@ietf.org, jsonpath@ietf.org, last-call@ietf.org, gen-art@ietf.org
Content-Type: multipart/alternative; boundary="000000000000bd828e06029847df"
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/4C-Kmn0Rs9pQFobLGe9l6BScrxw>
Subject: Re: [Gen-art] Genart last call review of draft-ietf-jsonpath-base-17
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:gen-art-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/gen-art/>
List-Post: <mailto:gen-art@ietf.org>
List-Help: <mailto:gen-art-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:gen-art-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 10 Aug 2023 21:28:49 -0000

 With respect, I disagree with the reviewer's characterization of the
document and thus with her conclusion.

As she says, this specification does not specify nor require any behavior
of JSON parsers, as specified at
https://www.rfc-editor.org/rfc/rfc8259.html#section-9 - it is orthogonal to
RFC8259.

Rather, it assumes that such a parser has, per 8259, transformed the JSON
text into another representation, one that allows software access to the
structure of the document, without concern for its input textual form. This
draft specifies the JSONPath syntax, and the results of applying that
syntax to such a representation.

I do not understand the reviewer’s point #2; is the syntax that might
change that of JSON itself, or of JSONPath?  If there is a revision of JSON
with new syntax (and presumably semantics), a large number of existing RFCs
that rely on the syntax and semantics in RFC8259 would have to change, this
among them. (This probably won’t happen.) The point about new parsing
techniques may be true, but is not relevant to this draft, which assumes
that the JSON input has been parsed and its structures made available to
software.

On the third point, IANA registration is proposed to give JSONPath a way to
evolve without core syntax modification, by providing a “function”
primitive; new functions may be created and, for interoperability and
namespace management, be registered.

<Co-chair hat: on> It is the consensus of the WG that a standards-track RFC
would be helpful to the community of developers who use JSONPath in a
variety of protocols and applications.

On Aug 10, 2023 at 11:18:21 AM, Linda Dunbar via Datatracker <
noreply@ietf.org> wrote:

> Reviewer: Linda Dunbar
> Review result: Not Ready
>
> I am the assigned Gen-ART reviewer for this draft. The General Area
> Review Team (Gen-ART) reviews all IETF documents being processed
> by the IESG for the IETF Chair.  Please treat these comments just
> like any other last call comments.
>
> For more information, please see the FAQ at
>
> <https://wiki.ietf.org/en/group/gen/GenArtFAQ>.
>
> Document: draft-ietf-jsonpath-base-17
> Reviewer: Linda Dunbar
> Review Date: 2023-08-10
> IETF LC End Date: 2023-08-09
> IESG Telechat date: Not scheduled for a telechat
>
> Summary:
>
> The document specifies a method to parse the JSON objects to get values and
> specifies the syntax to retrieve a list of values. The document reads well.
> However, like any software programs, errors can be encountered at run time
> even
> after careful review.
>
> Major issues:
> The major issue is that this document should not be “Standard Track”
> because:
> 1.      Existing parsers for JSON data don’t need to change to comply with
> the
> syntax specified in this document. 2.      Like SQL, this document
> specified
> syntax may change as more ways being developed by implementers to parse the
> JSON objects. 3.      It is not clear why IANA registration is needed.
>
> Minor issues:
>
> Nits/editorial comments:
>
> Thanks, Linda Dunbar
>
>
>