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

[Peter Saint-Andre <[e-mail]>]

<hat type='individual'/>

On 12/7/11 11: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.

As far as I know, there is no "rule" here.

>> 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...

Why not just copy the first sentence of the Abstract?

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

I suggest adding it to the start of this paragraph:

   URI Templates provide a mechanism for abstracting a space of resource
   identifiers such that the variable parts can be easily identified and
   described.  URI templates can have many uses, including discovery of
   available services, configuring resource mappings, defining computed
   links, specifying interfaces, and other forms of programmatic
   interaction with resources.  For example, the above resources could
   be described by the following URI templates:

Peter

-- 
Peter Saint-Andre
https://stpeter.im/