Re: [urn] URN namespace for NBNs

worley@ariadne.com (Dale R. Worley) Fri, 04 May 2018 02:37 UTC

Return-Path: <worley@alum.mit.edu>
X-Original-To: urn@ietfa.amsl.com
Delivered-To: urn@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8B926126DCA for <urn@ietfa.amsl.com>; Thu, 3 May 2018 19:37:02 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.685
X-Spam-Level:
X-Spam-Status: No, score=-1.685 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_LOW=-0.7, SPF_SOFTFAIL=0.665] autolearn=no autolearn_force=no
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 O9cMm_iCguiv for <urn@ietfa.amsl.com>; Thu, 3 May 2018 19:37:01 -0700 (PDT)
Received: from resqmta-ch2-09v.sys.comcast.net (resqmta-ch2-09v.sys.comcast.net [IPv6:2001:558:fe21:29:69:252:207:41]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 720A6124BFA for <urn@ietf.org>; Thu, 3 May 2018 19:37:01 -0700 (PDT)
Received: from resomta-ch2-09v.sys.comcast.net ([69.252.207.105]) by resqmta-ch2-09v.sys.comcast.net with ESMTP id EP8AfuKd9L7BSEQaifdBx2; Fri, 04 May 2018 02:37:00 +0000
Received: from hobgoblin.ariadne.com ([IPv6:2601:192:4603:9471:222:fbff:fe91:d396]) by resomta-ch2-09v.sys.comcast.net with ESMTPA id EQaefhvgqPhUCEQaffDDqA; Fri, 04 May 2018 02:36:59 +0000
Received: from hobgoblin.ariadne.com (hobgoblin.ariadne.com [127.0.0.1]) by hobgoblin.ariadne.com (8.14.7/8.14.7) with ESMTP id w442auwQ014522; Thu, 3 May 2018 22:36:56 -0400
Received: (from worley@localhost) by hobgoblin.ariadne.com (8.14.7/8.14.7/Submit) id w442asqc014518; Thu, 3 May 2018 22:36:54 -0400
X-Authentication-Warning: hobgoblin.ariadne.com: worley set sender to worley@alum.mit.edu using -f
From: worley@ariadne.com
To: juha.hakala@helsinki.fi
Cc: John C Klensin <klensin@jck.com>, L.Svensson@dnb.de, stpeter@stpeter.im, alexey.melnikov@isode.com, urn@ietf.org
In-Reply-To: <F7B5168013274F8F04FE8560@PSB> (klensin@jck.com)
Sender: worley@ariadne.com
Date: Thu, 03 May 2018 22:36:54 -0400
Message-ID: <871ses4055.fsf@hobgoblin.ariadne.com>
X-CMAE-Envelope: MS4wfPgm1z4Hi+ghmedCm+WM1rLgiggEwsSFaEqwUUmi53nlTjM9pvkEthEpRhayQ8ADo9tkrn2Bl7YK2qow7gtEY3QI3T7MszpJgz3dCyG7LyQKU1E5eQ9V hFQbihBwfHiMH1Xu7XveoNKqDA6T4e5P3MPN5Z3nm/zfWOXRvxNSXsaoLxGt7ie3HSNmUEyVHEvbHlsLs5DVTbqQpWhqaLg/bkcX1AU6lEpuVqddiSWPmHR5 SPWd2wffJIiVcxzGLC8z5ffUWj/D5WbZSJE/KNbvujWkSEuawf7IbWvwoWmQOiJgnZBFAiueJvnvALR0boeqMZg8z4zSdp5nOiYQq6yiYcI+XHS951Wwfw3w 1FC7vpgznwAq0El9EMharlq+t6ZpYhIXQ315v0Ubxl14BvLHd9I=
Archived-At: <https://mailarchive.ietf.org/arch/msg/urn/NDNdnXPeZy7dSwCLy7kKzHI8qe4>
Subject: Re: [urn] URN namespace for NBNs
X-BeenThere: urn@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Revisions to URN RFCs <urn.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/urn>, <mailto:urn-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/urn/>
List-Post: <mailto:urn@ietf.org>
List-Help: <mailto:urn-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/urn>, <mailto:urn-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 04 May 2018 02:37:02 -0000

The draft looks fine to me.  There are various nits, which I've listed
below.

Dale

----------------------------------------------------------------------

Various terminology like "hand-held", "immaterial", and "digital" is
used.  Do you have a clear terminology in mind?

2.  Conventions used in this document

   "NBN" refers to any National Bibliography Number identifier system
   used by the national libraries and other institutions, which use
   these identifiers with the national library's support and permission.

s/library's/libraries'/ since it is "support of libraries".  (Check
with the Editor!)

3.1.  The URN:NBN Namespace

   For instance, even if a digitized book has an ISBN, JPEG
   image files of its pages get NBNs.

You probably want to say "may get".

3.2.  Community Considerations for NBNs

   Note that the f-component is not a part of the NSS and therefore the ...

   Resources identified by NBNs are not always available in the ...

   If an NBN identifies an immaterial work, descriptive metadata about ...

These three paragraphs seem to be more about the resolution process
than community considerations.  Perhaps they can be separated in some
way?

4.1.  Overview

   uniqueness of the URN:NBNs at the global scale [Iso3166MA"/>.

This reference is corrupted.

4.2.  Encoding Considerations and Lexical Equivalence

   When an NBN is used as a URN, the namespace-specific string (NSS)
   MUST consist of three parts:

   o  a prefix, structured as a primary prefix, which is a two-letter
      ISO 3166-1 country code, ...

This doesn't specify *what* the country code must be.  Instead,

   When an NBN within a national library's identifier system is used
   as a URN, the namespace-specific string (NSS) MUST consist of three
   parts:

   o  a prefix, structured as a primary prefix, which is the two-letter
      ISO 3166-1 country code of the library's country, ...

5.  URN Namespace ID (NID) Registration for the National Bibliography
    Number (NBN)

   Declaration of syntactic structure of NSS part:

           nbn_string  = &lt;specific per prefix&gt;
                                         ; MUST adhere to RFC 3986 &lt;path-rootless&gt; syntax;
                                         ; parsers must regard nbn_strings as case-sensitive

There is trouble with <...> here.

      Colon MAY be used as a delimiting character only within the
      prefix, between ISO 3166-1 country code and sub-namespace code(s),
      which split the national namespace into smaller parts.

Comparing with the text in 4.2, I don't think this is phrased
correctly, as it may imply that colon may not appear in the
nbn_string.

      Reading it as:  Colon MAY be used (as a delimiting character
      only within the prefix) ...

Instead:

      Colon MAY be used within the prefix only as a delimiting
      character between the ISO 3166-1 country code and the
      sub-namespace code(s), which split the national namespace into
      smaller parts.

--

      See Section 4.2 of RFC XXXX for examples.

There should be a note telling the RFC Editor to insert the RFC number here.

   Process for identifier resolution:
      See Section 4.3 of RFC XXXX.

Ditto.

   Rules for lexical equivalence of NSS part:
      ...
      Formally, two URN:NBNs are lexically equivalent if they are octet-
      by-octet equal after the following (conceptional) preprocessing:

      1.  normalize the case of the leading "urn:" token;

This should be 'the leading "urn:nbn:" token', as otherwise the "nbn"
is not mentioned!

8.  Acknowledgements

   Revision of RFC 3188 started during the project PersID [PERSID] Later

Insert a full-stop after the reference.

9.  Contributors

   Alfred Hoenes was the editor and co-author of two of the documents
   from which this one is, in part, derived.

Is it possible to provide a description or reference to these
documents?  (One appears to be in the references already.)

Appendix A.  Significant Changes from RFC 3188

   Updated URN:NBN Namespace Registration template for IANA; whole
   document adapted to new URN Syntax document, RFC 2141bis, and new URN
   Namespace Registration document, RFC 3406bis (now retired and merged
   into 2141bis.

This paragraph is hard to read, and it has unbalanced parentheses.

   Use of query directives and fragment parts with this Namespace is now
   specified, in accordance with the aforementioned RFCs.

The terminology in RFC 8141 is "query components" and "fragment components".

[END]