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

I'll take that on board, thanks.

On 08/12/2011, at 10:23 PM, t.petch wrote:

> ----- Original Message -----
> From: "Mark Nottingham" <mnot@mnot.net>
> To: "Jiankang YAO" <yaojk@cnnic.cn>
> Cc: <draft-gregorio-uritemplate.all@tools.ietf.org>; "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
>> 
>> 
> 

--
Mark Nottingham   http://www.mnot.net/