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

"t.petch" <ietfc@btconnect.com> Thu, 08 December 2011 12:22 UTC

Return-Path: <ietfc@btconnect.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 51D5021F89B8 for <apps-discuss@ietfa.amsl.com>; Thu, 8 Dec 2011 04:22:12 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.275
X-Spam-Level:
X-Spam-Status: No, score=-2.275 tagged_above=-999 required=5 tests=[AWL=0.324, BAYES_00=-2.599]
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 hXZOKbfzuHep for <apps-discuss@ietfa.amsl.com>; Thu, 8 Dec 2011 04:22:11 -0800 (PST)
Received: from mail.btconnect.com (c2beaomr06.btconnect.com [213.123.26.184]) by ietfa.amsl.com (Postfix) with ESMTP id 46D2C21F889A for <apps-discuss@ietf.org>; Thu, 8 Dec 2011 04:22:09 -0800 (PST)
Received: from host86-177-208-97.range86-177.btcentralplus.com (HELO pc6) ([86.177.208.97]) by c2beaomr06.btconnect.com with SMTP id FQY06040; Thu, 08 Dec 2011 12:21:59 +0000 (GMT)
Message-ID: <039e01ccb59b$d54aa8e0$4001a8c0@gateway.2wire.net>
From: "t.petch" <ietfc@btconnect.com>
To: "Mark Nottingham" <mnot@mnot.net>, "Jiankang YAO" <yaojk@cnnic.cn>
References: <89527141FD764100A4B43FEDBC6E027F@LENOVO47E041CF><A253E377-4588-4A50-B837-8FE2E5082F15@mnot.net><583806B95F08410DBEFE3E04E79D28A4@LENOVO47E041CF> <39251BD7-21FD-48C4-A128-B578AD39D83D@mnot.net>
Date: Thu, 8 Dec 2011 12:23:20 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2800.1106
X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
X-Mirapoint-IP-Reputation: reputation=Fair-1, source=Queried, refid=tid=0001.0A0B0301.4EE0ABE6.005A, actions=TAG
X-Junkmail-Premium-Raw: score=9/50, refid=2.7.2:2011.12.8.113315:17:9.535, ip=86.177.208.97, rules=__HAS_MSGID, __OUTLOOK_MSGID_1, __SANE_MSGID, __TO_MALFORMED_2, __BOUNCE_CHALLENGE_SUBJ, __BOUNCE_NDR_SUBJ_EXEMPT, __MIME_VERSION, __CT, CT_TP_8859_1, __CT_TEXT_PLAIN, __CTE, __HAS_X_PRIORITY, __HAS_MSMAIL_PRI, __HAS_X_MAILER, USER_AGENT_OE, __OUTLOOK_MUA_1, __USER_AGENT_MS_GENERIC, __ANY_URI, CN_TLD, __CP_URI_IN_BODY, __CP_NOT_1, BODY_SIZE_1900_1999, BODYTEXTP_SIZE_3000_LESS, __MIME_TEXT_ONLY, RDNS_GENERIC_POOLED, BODY_SIZE_5000_LESS, RDNS_SUSP_GENERIC, __OUTLOOK_MUA, RDNS_SUSP, BODY_SIZE_2000_LESS, BODY_SIZE_7000_LESS
X-Junkmail-Status: score=10/50, host=c2beaomr06.btconnect.com
X-Junkmail-Signature-Raw: score=unknown, refid=str=0001.0A0B0208.4EE0ABE7.01F2, ss=1, re=0.000, fgs=0, ip=0.0.0.0, so=2011-07-25 19:15:43, dmn=2011-05-27 18:58:46, mode=multiengine
X-Junkmail-IWF: false
Cc: 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 12:22:12 -0000

----- Original Message -----
From: "Mark Nottingham" <mnot@mnot.net>
To: "Jiankang YAO" <yaojk@cnnic.cn>
Cc: <draft-gregorio-uritemplate.all@tools.ietf.org>rg>; "IETF Apps Discuss"
<apps-discuss@ietf.org>
Sent: Thursday, December 08, 2011 7:45 AM
Subject: Re: [apps-discuss] APPSDIR review of draft-gregorio-uritemplate-07
>
> > 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...

I agree that section 1 is a little weak but think the Abstract gets it (almost)
right.

"   A URI Template is a compact sequence of characters for describing a
   range of Uniform Resource Identifiers through variable expansion."

I would prefer
"  A URI Template is a compact sequence of characters which describes a
   range of Uniform Resource Identifiers through variable expansion."

and I would put that as section 1 first sentence, perhaps adding

"... A URI Template is not per se a URI but rather a potential URI in which
certain parts have been replaced by operators and variable names; the operators
have
been chosen to facilitate the construction of URIs, allowing the ready
generation
of such as name=value, or just value, in paths, queries and fragments, both of
single values or of lists of values."








>
> Regards,
>
>
> --
> Mark Nottingham   http://www.mnot.net/
>
>
>
> _______________________________________________
> apps-discuss mailing list
> apps-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/apps-discuss
>
>