Re: [apps-discuss] APPSDIR review of draft-gregorio-uritemplate-07

"Roy T. Fielding" <fielding@gbiv.com> Thu, 08 December 2011 22:23 UTC

Return-Path: <fielding@gbiv.com>
X-Original-To: apps-discuss@ietfa.amsl.com
Delivered-To: apps-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4CF2221F8545 for <apps-discuss@ietfa.amsl.com>; Thu, 8 Dec 2011 14:23:48 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -106.599
X-Spam-Level:
X-Spam-Status: No, score=-106.599 tagged_above=-999 required=5 tests=[AWL=-4.000, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id j2nlmi4Lyadj for <apps-discuss@ietfa.amsl.com>; Thu, 8 Dec 2011 14:23:47 -0800 (PST)
Received: from homiemail-a25.g.dreamhost.com (caiajhbdcbef.dreamhost.com [208.97.132.145]) by ietfa.amsl.com (Postfix) with ESMTP id ACCAC21F851A for <apps-discuss@ietf.org>; Thu, 8 Dec 2011 14:23:47 -0800 (PST)
Received: from homiemail-a25.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a25.g.dreamhost.com (Postfix) with ESMTP id 5070A678055; Thu, 8 Dec 2011 14:23:47 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gbiv.com; h=subject:mime-version :content-type:from:in-reply-to:date:cc:content-transfer-encoding :message-id:references:to; q=dns; s=gbiv.com; b=sz6xNzNwTlGx6JS5 6kIT40uVDwoczxT9Y2tfdV/QgNXQse7E9FQLT5/hSqMjrrl+B9zgwYR+IA35C5mH 7EubISC/VzSSfrEVutOnJPqKQQzSqpY5Y8+vw417ZSd0cyOL64Iz2NxtjBA5mBwm JoUm7yNUs9LXvY6BczI3wdS2sXo=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gbiv.com; h=subject :mime-version:content-type:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=gbiv.com; bh=5qxOmO9KELfFSfQyI9RyWUsqWz0=; b=XtOR3HxjIdPdP6WvucN4Mrnf2rSD EgGUW4hPykxzKaUhFQEahjO/Y7tTvk4zo5ouLE75n90U2GINNfmBfXeOvDAy/x5P Q0x3af92GY9he2jgpJvrGTamKKWNdO/ioCUV16LL3rUK6JaYiVIVPAXi/4Neh4d4 qznZ+1DGeCk0j1g=
Received: from [10.134.89.82] (unknown [75.103.10.98]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: fielding@gbiv.com) by homiemail-a25.g.dreamhost.com (Postfix) with ESMTPSA id 24AEC67803E; Thu, 8 Dec 2011 14:23:47 -0800 (PST)
Mime-Version: 1.0 (Apple Message framework v1251.1)
Content-Type: text/plain; charset=GB2312
From: "Roy T. Fielding" <fielding@gbiv.com>
In-Reply-To: <39251BD7-21FD-48C4-A128-B578AD39D83D@mnot.net>
Date: Thu, 8 Dec 2011 14:23:50 -0800
Content-Transfer-Encoding: quoted-printable
Message-Id: <F6B5D015-2A53-4544-9C8E-0E3B1B98C34F@gbiv.com>
References: <89527141FD764100A4B43FEDBC6E027F@LENOVO47E041CF> <A253E377-4588-4A50-B837-8FE2E5082F15@mnot.net> <583806B95F08410DBEFE3E04E79D28A4@LENOVO47E041CF> <39251BD7-21FD-48C4-A128-B578AD39D83D@mnot.net>
To: Mark Nottingham <mnot@mnot.net>
X-Mailer: Apple Mail (2.1251.1)
Cc: "draft-gregorio-uritemplate.all@tools.ietf.org" <draft-gregorio-uritemplate.all@tools.ietf.org>, IETF Apps Discuss <apps-discuss@ietf.org>
Subject: Re: [apps-discuss] APPSDIR review of draft-gregorio-uritemplate-07
X-BeenThere: apps-discuss@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion of application-layer protocols <apps-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/apps-discuss>
List-Post: <mailto:apps-discuss@ietf.org>
List-Help: <mailto:apps-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 08 Dec 2011 22:23:48 -0000

On Dec 7, 2011, at 10:45 PM, Mark Nottingham wrote:
> On 08/12/2011, at 5:41 PM, Jiankang YAO wrote:
>>> 
>>> Suggestion: for example, we just say "ALPHA, DIGIT are imported from RFC5234" instead of repeating
>>> "ALPHA          =  %x41-5A / %x61-7A   ; A-Z / a-z"
>> 
>> ==>Is this a discussion that's already taken place?
>> 
>> yes. the rule has been followed by EAI WG.
> 
> Do you have a reference? I.e., is this an IESG ruling, or something that was decided in that WG? As has mentioned, taking the approach you outline will result in ABNF errors.

FWIW, I am opposed to making this change.  IMO, it is trivial for
any one of the reviewers prior to publication to verify that the
rules were copy and pasted correctly.  That's why they are all in
one section.  After that, the specification will be read by thousands
of people and used as a reference in hundreds of implementations, and
occasionally even automatically checked with abnf parsers.  The cost
of splitting the normative information across multiple specs is not
worth the theoretical notion that someone might copy them incorrectly.

These are not cases of independently developed protocol elements
that might be updated over time.  They are simply character sets.
We don't want them to be updated over time.  And they are essential
to understanding exactly what characters are allowed in each of
the rules in the main spec.

>> 4)There is a lot of "A URI Template" in section 1, but there is no precise definition of "URI Template" in section 1. The definition seems to appear on section 2.
>>> Comments: If the readers can understand it clearly, the definition should appear first.
>> 
>> ==>Could you make a concrete proposal here?
>> 
>> what is "URI Template" should be defined in section 1.
>> there is no precise or clear definition of "URI Template" in section 1.
> 
> I was hoping for something more substantial. Let me take another look at it...

It is defined in the abstract. *shrug*

....Roy