RE: Comments on draft-adid-urn-00

Jarrett Wold <jwold@ad-id.org> Wed, 23 March 2016 15:24 UTC

Return-Path: <jwold@ad-id.org>
X-Original-To: urn-nid@ietfa.amsl.com
Delivered-To: urn-nid@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4993C12D5DE for <urn-nid@ietfa.amsl.com>; Wed, 23 Mar 2016 08:24:48 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.691
X-Spam-Level:
X-Spam-Status: No, score=-2.691 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001, T_FILL_THIS_FORM_SHORT=0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=ad-id.org
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id FaU7cdHtBQPD for <urn-nid@ietfa.amsl.com>; Wed, 23 Mar 2016 08:24:41 -0700 (PDT)
Received: from mail-pf0-x22f.google.com (mail-pf0-x22f.google.com [IPv6:2607:f8b0:400e:c00::22f]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 29CF812D5D6 for <urn-nid@apps.ietf.org>; Wed, 23 Mar 2016 08:24:41 -0700 (PDT)
Received: by mail-pf0-x22f.google.com with SMTP id u190so32575581pfb.3 for <urn-nid@apps.ietf.org>; Wed, 23 Mar 2016 08:24:41 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ad-id.org; s=google; h=from:references:in-reply-to:mime-version:thread-index:date :message-id:subject:to:cc; bh=aZ3dJPePzmW2efIWBsWuNvESSKi9hsHzXvnh7QKxcpY=; b=NPJ6VVtzKavocnIwLuPj5k3FIZvq15J5LOElfG7bDADMX/+XkAOpGSV4lveUR3+qaJ jMz4PJzFG8VmlRUhgMlu+x8BK0n0W9t7sAA+yPd6rPlhzSpkJUt0ONuOQtmMn8R2xFcI /94BzLTai/1FUmnH3JK0JhSqT0iNwwpbS5czs=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:references:in-reply-to:mime-version :thread-index:date:message-id:subject:to:cc; bh=aZ3dJPePzmW2efIWBsWuNvESSKi9hsHzXvnh7QKxcpY=; b=VGbEKAq5DpVwTTI1GG5Lm98gHwAwPomEutDvWVIULBr7AlARlp+hf+4er+V46xn9VD 3vOtxh2yYui4Z2VlM3tj4TA1V1L+VXR3flYpXOm1iFuBdTVZwJP/Y6iTww7GYjGJlwtG wEoMA8lmkFhFvzFoUy2V/9d0tWq6w5RUPLPNgky8WDcHVgC/aLYXP3UBvITSG0wPhR0g qVRp7knw0lDb8Lbh6L2/TtqDdad86S+/vBu9aa5bA7ydYO1JS0yq5XWQctNaUgSAaLED daRnwCQ4PY8jLiCsDAbk74P0MqhrwdLRdqfBEri7FLqRH3Tr3z/rQujBW3k6dHZ6QyGA jY4w==
X-Gm-Message-State: AD7BkJLWZY906fP15JvPiWjNn4MSkS7RUNBBG2Mk104OCNums/Wwa0J6fGeOs/Tp3X5FQwaCU/i2ZsrJjGhWTSdD
X-Received: by 10.98.76.216 with SMTP id e85mr5117631pfj.121.1458746680726; Wed, 23 Mar 2016 08:24:40 -0700 (PDT)
From: Jarrett Wold <jwold@ad-id.org>
References: <22a133140ac0f17928f11266f44d5e38@mail.gmail.com> (jwold@ad-id.org) <87twk8cves.fsf@hobgoblin.ariadne.com>
In-Reply-To: <87twk8cves.fsf@hobgoblin.ariadne.com>
MIME-Version: 1.0
X-Mailer: Microsoft Outlook 15.0
Thread-Index: AQJ3xaDQ1RwFcsnWEeBMf8XCPFIDzp4ao/5A
Date: Wed, 23 Mar 2016 11:25:27 -0400
Message-ID: <38ccac03ec92863a817a821cfc7802da@mail.gmail.com>
Subject: RE: Comments on draft-adid-urn-00
To: "Dale R. Worley" <worley@alum.mit.edu>
Content-Type: multipart/mixed; boundary=001a11354ce8b9c2f6052eb8ed29
Archived-At: <http://mailarchive.ietf.org/arch/msg/urn-nid/phSPOHwECoZIXXnanrUhLoW800k>
Cc: urn-nid@apps.ietf.org
X-BeenThere: urn-nid@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: discussion of new namespace identifiers for URNs <urn-nid.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/urn-nid>, <mailto:urn-nid-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/urn-nid/>
List-Post: <mailto:urn-nid@ietf.org>
List-Help: <mailto:urn-nid-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/urn-nid>, <mailto:urn-nid-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 23 Mar 2016 15:24:48 -0000

Hello Dale -
I tried to submit as this as an ID, however, the site is saying the ID
Tool won't be available until 4/3.

I made a lot of changes to the document based on the feedback. I removed
the references to the GUID (probably not needed) and hopefully clarified
more within the doc and references.  Thank you again for your feedback.

Please see the attached draft for review.  Hopefully, this draft is a lot
cleaner.


Jarrett Wold | Ad-ID LLC
Director of Technology & Platforms
646-708-8131
jwold@ad-id.org



-----Original Message-----
From: Dale R. Worley [mailto:worley@alum.mit.edu]
Sent: Monday, March 14, 2016 10:44 PM
To: Jarrett Wold <jwold@ad-id.org>;
Cc: urn-nid@apps.ietf.org
Subject: Comments on draft-adid-urn-00

Here are a bunch of comments on draft-adid-urn-00.  Overall the concept
seems fine, but the document needs cleaning up.

The title contains "Adverting".  Have you run the draft through a spelling
checker?

      The following is an example of an Ad-ID Identifier in its
      canonical representation:

             ABCD0001000

      The canonical URN representation of the same Ad-ID Identifier is:

         urn:adid:ABCD0001000
         urn:adid:ABCD0001000H


      The 32-bit unique representation of the Ad-ID is:

         urn:adid:cuid:36faeaba

This example is difficult to follow.  The first item is straightforward,
as it is an 11 character string.  But the next item isn't clear:  by
definition, a "canonical" representation is one representation chosen from
among many.  You can say that both

         urn:adid:ABCD0001000
         urn:adid:ABCD0001000H

are URN representations of the Ad-ID identifier, but only one of them can
be canonical.  Also, it would be helpful if you explained why both URNs
correspond to ABCD0001000, or at least provide a reference to some
description which will explain it.

But, reading http://www.ad-id.org/how-it-works/ad-id-structure, it seems
that ABCD0001000H is not the *same* Ad-ID as ABCD0001000, but rather the
Ad-ID for the corresponding High Definition version of the asset.  You
need to clarify this so that the example is not misleading.

It is not clear how the further "32-bit unique representation"
corresponds to the preceding three representations.  It's reasonably clear
what "32-bit" means as the URN contains a sequence of 8 hex digits, but
it's completely unclear what is "unique" about it.

Remember, this is the introduction, which should be readable by people who
don't already understand the technology, including people who don't
already understand Ad-IDs in all their forms.

There's some general trouble about the indentation of text.  For instance,
it seems that "The identifier structure is as follows:"
should be 4 spaces to the left, "Non alphanumeric ("special") characters
and spaces are not valid within an Ad-ID." should have a blank like above
it and be moved 3 spaces to the left, and "A Canonical Full Ad-ID ..."
should be moved 1 space to the left.

This text has some redundancy that should be removed:

          A Canonical Full Ad-ID Identifier shall conform to the syntax
          specified below using ABNF (as specified in IETF RFC 5234):
          The URN representation URN-ADID of an Ad-ID Identifier
          conforms to the syntax (expressed using ABNF (as specified in
          [RFC5234]):

The production

          adid_prefix = (ALPHA / %x30-39) 4*alphanum
               ; first character not zero

is incorrect on two counts:  As written, the first character can be zero
(which ix %x30).  The strings generated are 5 characters.  What you want
is

          adid_prefix = (ALPHA / %x31-39) 3*alphanum
               ; first character not zero

The instances of ALPHA and DIGIT might be intended to be "alpha" and
"digit".  Or do you mean to reference the productions ALPHA and DIGIT in
RFC 5234?  If so, you should eliminate the productions for "alpha"
and "digit" in the draft.

The BNF does not show how the "urn:adid:cuid" URNs are generated.  As the
BNF now stands, those examples are invalid.

      Ad-ID URNs are resolved via URN resolvers run under Ad-ID's
      responsibility.

It would be helpful here to provide a pointer to the documentation for the
resolvers.

      The validity of an URN-ADID can be checked using Ad-ID's web
      services.

Ditto.

Dale