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

Alexey Melnikov <alexey.melnikov@isode.com> Sat, 10 December 2011 23:15 UTC

Return-Path: <alexey.melnikov@isode.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 0BB3121F8B25 for <apps-discuss@ietfa.amsl.com>; Sat, 10 Dec 2011 15:15:08 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.599
X-Spam-Level:
X-Spam-Status: No, score=-102.599 tagged_above=-999 required=5 tests=[AWL=0.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 5jSPDuAchI-a for <apps-discuss@ietfa.amsl.com>; Sat, 10 Dec 2011 15:15:07 -0800 (PST)
Received: from rufus.isode.com (rufus.isode.com [62.3.217.251]) by ietfa.amsl.com (Postfix) with ESMTP id 330C021F8B23 for <apps-discuss@ietf.org>; Sat, 10 Dec 2011 15:15:07 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1323558906; d=isode.com; s=selector; i=@isode.com; bh=Q79g6IN+jcJMY9FYDWE/+ce+LrMw+YQndqM73uCmVFA=; h=From:Sender:Reply-To:Subject:Date:Message-ID:To:Cc:MIME-Version: In-Reply-To:References:Content-Type:Content-Transfer-Encoding: Content-ID:Content-Description; b=Ii2/mOpsJo6BECTH3DjFzUyDC9hROpc9Yosz/oj5fh72Ft0DnDOoK0j7RYuEFkiwpAkA6v ZzKFKL7yeadpkfRftrj+P3LJ9AYLJVhfpqqH+/mL1TXwaptpnoV7bsOENHffhj9E26/1mi Yh25VaUToPPHu/8rud+vri22JQidZvY=;
Received: from [188.29.165.210] (188.29.165.210.threembb.co.uk [188.29.165.210]) by rufus.isode.com (submission channel) via TCP with ESMTPSA id <TuPn9ABaK7TL@rufus.isode.com>; Sat, 10 Dec 2011 23:15:04 +0000
Message-ID: <4EE3E7F1.2010508@isode.com>
Date: Sat, 10 Dec 2011 23:14:57 +0000
From: Alexey Melnikov <alexey.melnikov@isode.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; rv:8.0) Gecko/20111105 Thunderbird/8.0
To: Mark Nottingham <mnot@mnot.net>
References: <89527141FD764100A4B43FEDBC6E027F@LENOVO47E041CF> <A253E377-4588-4A50-B837-8FE2E5082F15@mnot.net>
In-Reply-To: <A253E377-4588-4A50-B837-8FE2E5082F15@mnot.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: IETF Apps Discuss <apps-discuss@ietf.org>, draft-gregorio-uritemplate.all@tools.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: Sat, 10 Dec 2011 23:15:08 -0000

On 07/12/2011 09:07, Mark Nottingham wrote:
> Thanks for the feedback. Responses inline.
>
> On 07/12/2011, at 2:18 PM, Jiankang YAO wrote:
>> I have been selected as the Applications Area Directorate reviewer
>> for this draft (for background on appsdir, please
>> see
>> http://trac.tools.ietf.org/area/app/trac/wiki/ApplicationsAreaDirectorate
>> ).
>> Please resolve these comments along with any other Last Call comments
>> you may receive. Please wait for direction from your document
>> shepherd or AD before posting a new version of the draft.
>>
>> Document: draft-gregorio-uritemplate-07
>> Title: URI Template
>>
>> Reviewer: Jiankang Yao
>> Review Date: December 7, 2011
>>
>> Summary:
>>
>> This draft is almost ready for publication as a Proposed Standard. But before publication, the following
>> issues should be considered or addressed.
>>
>> Major issues:
>>
>>
>> 1) In section 1.5.  Notational Conventions
>>
>> There is a repetition of definition of ALPHA, DIGIT, HEXDIG,......
>>
>> There is a discussion in IETF: we should not give the repetition of definition of ABNF syntax if we can refer it to other documents. The reason is that repetition may bring the errors or misunderstanding.
>>
>> 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?
By copying definitions from other specs (instead of referencing them), 
you are risking introducing new errors and also risking that your 
document will not be updated when the referenced documents are updated.

My personal preference is not to copy definitions, but there is no hard 
rule on this.