Re: [Ecrit] draft-ietf-ecrit-additional-data-14: Naming consistency of various parameters / namespaces

Hannes Tschofenig <hannes.tschofenig@gmx.net> Fri, 25 October 2013 12:02 UTC

Return-Path: <hannes.tschofenig@gmx.net>
X-Original-To: ecrit@ietfa.amsl.com
Delivered-To: ecrit@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EA4C211E83D2 for <ecrit@ietfa.amsl.com>; Fri, 25 Oct 2013 05:02:49 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.623
X-Spam-Level:
X-Spam-Status: No, score=-102.623 tagged_above=-999 required=5 tests=[AWL=-0.024, 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 YupIabZ7JIiy for <ecrit@ietfa.amsl.com>; Fri, 25 Oct 2013 05:02:41 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.22]) by ietfa.amsl.com (Postfix) with ESMTP id E4AE411E83D1 for <ecrit@ietf.org>; Fri, 25 Oct 2013 05:02:40 -0700 (PDT)
Received: from [172.16.254.200] ([80.92.115.161]) by mail.gmx.com (mrgmx103) with ESMTPSA (Nemesis) id 0MZU7V-1VHAfq3wQn-00LDkM for <ecrit@ietf.org>; Fri, 25 Oct 2013 14:02:40 +0200
Message-ID: <526A5DF7.2050201@gmx.net>
Date: Fri, 25 Oct 2013 14:03:03 +0200
From: Hannes Tschofenig <hannes.tschofenig@gmx.net>
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.0
MIME-Version: 1.0
To: Matt Serra <mserra@ravemobilesafety.com>, "ecrit@ietf.org" <ecrit@ietf.org>
References: <6B92B1E73D1E7B468E5C97CAE569CBA12156F6E283@MBX05.exg5.exghost.com>
In-Reply-To: <6B92B1E73D1E7B468E5C97CAE569CBA12156F6E283@MBX05.exg5.exghost.com>
Content-Type: text/plain; charset="ISO-8859-1"; format="flowed"
Content-Transfer-Encoding: 7bit
X-Provags-ID: V03:K0:m5kaaCn8NHY+p6wOQEC2+Bby4qzqCaLfGvE0n784aMVPOKg3G+8 serEO0PiLmR5VrHm8pIOlW5MDztXCtYKXuaXnyBVlnwj1rRpG69pxbX7TyWcHsBeo0ekr6P q13iMgEVORzI0tqK3v4k6852U+Zdohf5R58ER4vwYqrdIhyy3ADBGf/Abof8vHjcWnC1ACM i/5O8U1hsTC3u2Nql8soQ==
Subject: Re: [Ecrit] draft-ietf-ecrit-additional-data-14: Naming consistency of various parameters / namespaces
X-BeenThere: ecrit@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: <ecrit.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ecrit>, <mailto:ecrit-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ecrit>
List-Post: <mailto:ecrit@ietf.org>
List-Help: <mailto:ecrit-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ecrit>, <mailto:ecrit-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 25 Oct 2013 12:02:50 -0000

Hi Matt,

thanks for the detailed review and for spotting these inconsistencies.

On 10/23/2013 05:33 PM, Matt Serra wrote:
> In reviewing the latest additional data draft (v14) - I noticed that
> there are a few inconsistencies that should be addressed.  Issues and
> thoughts are below.
>
> I ask that whatever is decided recognize that other forms of
> additional data will be defined (Additional Caller and Additional
> Location data), so we should pick names that don't limit our options
> when those are introduced.
>
> 1) Section 9.2 - The purpose parameter in the table should read as
> 'emergencyCallData' per the section title.
>

Fixed.

> 2) Section 9.4 - We may want to reconsider renaming the MIME
> registrations to match the purpose parameter name.  Section 9.4 calls
> for a pattern of 'emergencyCallData.<block>+xml'

Makes sense.

>
> 3) Section 9.5: the various URN Sub-Namespace registrations are named
> inconsistently.  We should iron this out:
>
> - urn:ietf:params:xml:ns:emergencyCallAddlData -
> urn:ietf:params:xml:ns:emergencyCallProviderInfo -
> urn:ietf:params:xml:ns:emergencyCall.SvcInfo -
> urn:ietf:params:xml:ns:emergencyCall.DevInfo -
> urn:ietf:params:xml:ns:emergencyCall.SubInfo -
> urn:ietf:params:xml:ns:emergencyCall.Comment

I changed it to

urn:ietf:params:xml:ns:emergencycalldata:<block>

>
> 4) The schema registries in section 9.6 are different still from
> section 9.5. These should agree, no?

They should be aligned for better readability.

Thanks a lot for the review.

I am working on the updated version and will post a link to the new 
document to the list. Might take a little while since I have to fix 
examples and schemas as well.

Ciao
Hannes


>
> Thanks,
>
> Matthew A. Serra, ENP Sr. Director, Product Management Rave Mobile
> Safety | Smart911 Mobile:  201.245.1557 mserra@ravemobilesafety.com
>
>
> _______________________________________________ Ecrit mailing list
> Ecrit@ietf.org https://www.ietf.org/mailman/listinfo/ecrit
>